context-cli

CLI for Context Engineering. Create and manage PRDs/PRPs, enforce guardrails, build RAG indexes, and execute PRPs with AI agents.

Getting Started (Codex‑friendly)

1. Install globally

npm i -g context-engineering-cli@latest

The installer ensures your shell PATH includes the npm global bin (idempotent). If it cannot update automatically, it will print a one‑line follow‑up.

2. In any folder (e.g., your project directory)

context-cli init
context-cli doctor --verbose

You should see “All checks OK” and the 4 templates under context/templates/.

Troubleshooting (rare)

• If context-cli is not found right after install:
  • context-cli setup path --write
  • exec $SHELL -l (reload your shell)

Common Commands

• Bootstrap: context-cli init
• Diagnostics: context-cli doctor --verbose
• PRD: context-cli prd new
• PRP: context-cli prp new --type arch|feat|bugfix
• Status (Kanban): context-cli status
• Guardrails: context-cli guard check
• RAG build/search:
  • Put .md/.txt in context/rag/corpus/
  • context-cli rag build
  • context-cli rag search "keyword"
• Exec (AI plan/run):
  • context-cli exec <PRP_ID> --plan
  • context-cli exec <PRP_ID> --run

Flags

• --verbose enables debug logs
• --trace enables trace logs
• --json prints structured JSON logs

Usage

context-cli --version
context-cli --help

Development

npm run dev -- --help
npm run build
npm run lint
npm test

License

MIT