@contextor/cli
v1.0.6
Published
CLI tool for installing Contextor prompt coaching in your projects
Maintainers
Readme
@contextor/cli
The official CLI for installing Contextor in your development projects.
Contextor is a prompt coaching system that helps development teams improve their AI prompting skills through automated capture, analysis, and feedback.
Installation
No global installation required! Use npx to run directly:
npx @contextor/cli init <install-token>Requirements
- Node.js 18.0.0 or higher
- Claude Code installed (for hook integration)
Usage
Initialize Contextor
Get your install token from the Contextor dashboard, then run:
npx @contextor/cli init <your-install-token>This will:
- Create
.contextor/config.json(shared project config, committed to git) - Create
.contextor/.user(your personal API key, gitignored) - Configure Claude Code hooks for automatic prompt capture
- Test the connection to Contextor cloud
Check Status
Verify your installation is working:
npx @contextor/cli statusUninstall
Remove your personal Contextor configuration from the project:
npx @contextor/cli uninstallGetting Your Install Token
- Log in to contextor.co
- Navigate to your project settings
- Copy the install token (starts with
ctx_) - Run
npx @contextor/cli init <token>
What Gets Created
| File | Purpose | Git Status |
|------|---------|------------|
| .contextor/config.json | Shared project configuration | Committed |
| .contextor/.user | Personal API key | Gitignored |
| .claude/settings.json | Claude Code hook configuration | Committed |
| .claude/hooks/contextor-capture.sh | Capture script | Committed |
How It Works
Once installed, Contextor automatically captures your prompts when using Claude Code. Each prompt is:
- Captured - Sent securely to Contextor cloud
- Redacted - Secrets and sensitive data are removed
- Analyzed - AI scores your prompt on 5 dimensions
- Stored - Available in your dashboard with improvement suggestions
Documentation
Full documentation at contextor.co/docs
Support
License
MIT
