@context-engine-ai/cli
v0.9.1
Published
CLI for the context-engine knowledge base — one-command setup (init), docker compose wrapper, workspace/repo management, search, and review.
Readme
@context-engine-ai/cli
CLI for context-engine — a self-hosted knowledge base that indexes your repos and injects relevant context into Claude Code sessions.
npm install -g @context-engine-ai/cliQuick start
context-engine init # one-command setup: docker compose up + hook install
context-engine status # check the engine, workers, and indexed repos
context-engine login # sign in (only needed if the engine requires auth)Commands
| Command | Purpose |
|---|---|
| init | One-command setup — starts the docker stack and installs Claude Code hooks |
| config show | Print resolved config (engine URL, auth state) |
| status | Health of the API, job worker, and indexed repos |
| workspace create <id> <name> | Create a workspace to scope retrieval |
| repo add <path> <id> -w <workspace> | Register a local repo for indexing |
| repo index <repo-id> [--wait] | Trigger (re)indexing for a repo |
| search "<query>" | Run a retrieval query from the terminal |
| review list / show <id> / promote <id> | Review and promote draft reflection candidates |
| outcomes related <id> | Find sessions correlated with a production outcome |
| docker up / docker logs <service> | Wrapper around the engine's docker compose stack |
| ui | Open the local observability dashboard |
| login / logout | Authenticate against a hosted engine |
Run context-engine --help or context-engine <command> --help for full
flags and examples.
Environment
| Variable | Default | Purpose |
|---|---|---|
| CONTEXT_ENGINE_URL | http://localhost:3333 | API base URL the CLI talks to |
See the main repo README for architecture, self-hosting, and the Claude Code hook setup this CLI installs.
