{"id":25120,"library":"context-compiler-cli","title":"context-compiler-cli","description":"Context-compiler-cli is a CLI tool for analyzing, linting, and deterministically optimizing LLM prompt/context files. Current stable version is 0.2.3, released with active development cadence. It provides commands like compact, analyze, lint, and optimize, with tokenizer options (char, o200k_base). Differentiators include deterministic compaction preview and config persistence without JSON editing. Requires Node >=18.","status":"active","version":"0.2.3","language":"javascript","source_language":"en","source_url":"https://github.com/4l1n/context-compiler","tags":["javascript","llm","prompt","context","cli","tokenizer","lint"],"install":[{"cmd":"npm install context-compiler-cli","lang":"bash","label":"npm"},{"cmd":"yarn add context-compiler-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add context-compiler-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"core library providing API and logic","package":"context-compiler","optional":false}],"imports":[{"note":"Install globally for CLI usage, not as a project dependency.","wrong":"npm install context-compiler-cli --save","symbol":"cli","correct":"npx ctxc --help"},{"note":"Primary command is ctxc; context-compiler is a compatibility alias.","wrong":"context-compiler analyze file.md","symbol":"ctxc","correct":"ctxc analyze file.md --tokenizer o200k_base"},{"note":"Alias works for basic commands but prefer ctxc.","wrong":"","symbol":"context-compiler","correct":"context-compiler --help"}],"quickstart":{"code":"npm install -g context-compiler-cli\nctxc --help\nctxc compact --text \"You are helpful. You are helpful.\"","lang":"bash","description":"Install CLI globally, verify help, then run deterministic compaction preview on sample text."},"warnings":[{"fix":"Upgrade Node to 18+ with nvm install 18","message":"Requires Node >=18; older versions will fail.","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Specify desired tokenizer with --tokenizer flag or config set.","message":"Token option 'o200k_base' may produce different results than 'char'; not a bug but intended behavior.","severity":"gotcha","affected_versions":">=0.2.0"},{"fix":"Use ctxc for all commands.","message":"Using 'context-compiler' command instead of 'ctxc' may be deprecated in future versions.","severity":"deprecated","affected_versions":">=0.2.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run npm install -g context-compiler-cli or use npx ctxc","cause":"npm global install not in PATH or not installed globally","error":"command not found: ctxc"},{"fix":"Use valid tokenizer: char or o200k_base; check spelling.","cause":"Tokenizer name misspelled or not available in current version","error":"Error: Could not resolve tokenizer 'o200k_base'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}