# Agent SDK Quick Reference Card

## 🚀 Quick Start

```bash
# Install dependencies
pip install -r requirements.txt

# Run bot (Agent SDK is default)
python bot_runner.py
```

## 📋 Mode Selection

### Agent SDK (Default)
```env
# No config needed - this is the default!
# Or explicitly:
USE_AGENT_SDK=true
```
✅ Uses Claude Pro subscription (no API costs)

### Direct API
```env
USE_DIRECT_API=true
ANTHROPIC_API_KEY=sk-ant-...
```
✅ Pay-per-token, usage tracking enabled

### Legacy Server
```env
USE_CLAUDE_CODE_SERVER=true
CLAUDE_CODE_SERVER_URL=http://localhost:8000
```
⚠️ Deprecated, not recommended

## 🔍 Verify Mode

Check startup message:
```
[LLM] Using Claude Agent SDK (Pro subscription)  ← Agent SDK ✅
[LLM] Using Direct API (pay-per-token)          ← Direct API 💳
[LLM] Using Claude Code server at ...           ← Legacy ⚠️
```

## 🧪 Test Installation

```bash
python test_agent_sdk.py
```

Expected: **5/5 tests passed** 🎉

## 🛠️ Troubleshooting

### Issue: Fallback to Direct API
```bash
pip install claude-agent-sdk anyio
```

### Issue: ModuleNotFoundError
```bash
pip install -r requirements.txt
```

### Issue: Still using old mode
```bash
# Edit .env and remove conflicting variables
USE_DIRECT_API=false  # or remove line
```

## 📊 Priority Order

```
1. USE_DIRECT_API=true     → Direct API
2. USE_CLAUDE_CODE_SERVER  → Legacy
3. USE_AGENT_SDK (default) → Agent SDK
4. SDK unavailable         → Fallback to Direct API
```

## 💰 Cost Comparison

| Mode | Cost per 1M tokens |
|------|-------------------|
| Agent SDK | **$0** (Pro subscription) |
| Direct API (Haiku) | $0.25 - $1.25 |
| Direct API (Sonnet) | $3.00 - $15.00 |

## 🎯 Key Files

| File | Purpose |
|------|---------|
| `llm_interface.py` | Core implementation |
| `requirements.txt` | Dependencies |
| `test_agent_sdk.py` | Test suite |
| `.env` | Configuration |

## 📚 Documentation

- `AGENT_SDK_IMPLEMENTATION.md` - Full technical details
- `MIGRATION_GUIDE_AGENT_SDK.md` - Step-by-step migration
- `IMPLEMENTATION_SUMMARY.md` - Executive summary
- `QUICK_REFERENCE_AGENT_SDK.md` - This file

## ✅ Features Preserved

✅ All 17 tools (file ops, Gmail, Calendar)
✅ Scheduled tasks
✅ Memory system
✅ Self-healing system
✅ Telegram adapter
✅ Slack adapter
✅ Model switching (/sonnet, /haiku)
✅ Usage tracking (Direct API mode)

## 🔄 Rollback

```env
# Quick rollback to Direct API
USE_DIRECT_API=true
ANTHROPIC_API_KEY=sk-ant-...
```

Restart bot. Done! ✅

## 📞 Support

1. Check logs: Look for `[LLM]` messages
2. Run tests: `python test_agent_sdk.py`
3. Check mode: Verify startup message
4. Review docs: See files above

---

**Version**: 1.0.0
**Date**: 2026-02-15
**Status**: ✅ Production Ready