# 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](./USAGE_GUIDE.md)** - 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

### Example Scenarios

```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 <repo>
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