Context CLI - Ambient Intelligence for Your Terminal

Context CLI adds an intelligent layer to your terminal that learns from your command patterns and provides real-time suggestions to prevent errors and improve productivity.

📖 Complete Usage Guide & Productivity Hacks - Comprehensive guide with real-world examples

Features

- 🧠 Smart Suggestions: Warns you before running commands in the wrong context
- 🔍 Pattern Detection: Learns from your command history to identify workflows
- ⚡ Real-time Analysis: Instant feedback before command execution
- 🛡️ Safety First: Prevents dangerous commands and common mistakes
- 📊 Usage Analytics: Track your command patterns and improve workflows

Installation

``bash
npm install -g context-cli

Install shell hooks (required)


context install --shell zsh # or bash, fish
`

How It Works

Context CLI integrates with your shell to:

1. Analyze commands before execution
2. Detect patterns in your workflow
3. Provide suggestions based on context
4. Learn from your command history

$3

`bash


Detects missing npm install

$ npm test
⚠️ package.json has changed since last npm install
Suggested: npm install

Warns about wrong branch

$ npm run deploy
⚠️ You're on branch 'feature' but usually run this on 'main'

Prevents disasters

$ rm -rf /
❌ This will delete your root directory!
`

Commands

- context install - Install shell hooks
- context stats - View usage statistics
- context config - Configure settings and AI
- context-on - Enable context (in shell)
- context-off - Disable context (in shell)

AI Integration (New!)

Context CLI now supports AI-powered suggestions using OpenAI's API:

`bash


Set your OpenAI API key

context config --set-openai-key YOUR_API_KEY

Enable AI suggestions

context config --enable-ai

Optional: Choose a specific model (default: gpt-4-turbo-preview)

context config --set-model gpt-4o

View configuration

context config --show
`

With AI enabled, you get:
- 🧠 Smarter pattern detection across your workflow
- 🔮 Predictive suggestions based on context
- 🎯 More accurate error prevention
- 📚 Learning from your specific development style

Privacy

All data is stored locally in ~/.context-cli/. No data is sent to external servers.

Development

`bash


Clone and install

git clone
cd context-cli
npm install

Build

npm run build

Watch mode

npm run dev
``

Architecture

- Pattern Detection: Sliding window analysis of command sequences
- Context Building: Git branch, directory, file changes, environment
- Storage: SQLite database for command history and patterns
- Shell Integration: Hooks for bash, zsh, and fish

License

MIT