AI IQ — Claude Code Session Coach

Real-time coaching for your Claude Code sessions. AI IQ monitors your JSONL transcripts as you work, detects anti-patterns, and surfaces actionable feedback — so you get better results from every session.

AI IQ Panel

Why AI IQ?

Claude Code is powerful, but sessions can go off the rails — error loops, scope creep, blind edits without reading code first. AI IQ watches your session in real time and coaches you before problems compound.

Zero cost by default. The heuristic engine runs locally with no API calls. Optional deep analysis uses your own API key.

Features

Live Session Monitoring

Auto-detects your active Claude Code session (CLI or extension)
Parses JSONL transcripts in real time as new messages arrive
Polls every 15 seconds for new sessions — switch between CLI and extension seamlessly

Rolling Metrics Dashboard

Planning ratio — Are you reading before editing?
Error chain — Consecutive errors that signal a broken approach
Verification rate — How often you check Claude's work
Cache hit ratio — Token efficiency from prompt caching
Token counts & cost — Input, output, and estimated USD spend
Model usage — Per-model breakdown (Opus, Sonnet, Haiku)
Session duration & message count

Sentiment Analysis

AI IQ tracks the vibe of your session using developer-specific sentiment scoring:

SMOOTH — Session is going well
NEUTRAL — Normal working pace
FRICTION — Growing tension in your messages
STRUGGLING — Frustration detected, time to step back

Sentiment uses a custom lexicon tuned for developer conversations (not generic NLP). It detects phrases like "doesn't work", "still broken", "not what I asked" alongside positive signals like "perfect", "looks good", "that works". Behavioral signals like ALL CAPS and terse responses are also tracked.

Smart Alerts (7 Types)

Alert	Triggers when...
Error Chain	3+ consecutive errors — the current approach isn't working
Over-Prompting	Your message exceeds ~2000 tokens — Claude remembers context
Re-Explaining	You're repeating yourself (Jaccard similarity > 60%)
Blind Charging	Low planning ratio — lots of edits, little reading
Scope Creep	Session touches 5+ unrelated directories
No Verification	20+ messages without checking Claude's output
Frustration Rising	Sentiment drops to "frustrated" with declining trend

Each alert includes:

A clear explanation of what's happening
A suggestion for what to do
A one-click "Add to CLAUDE.md" button that injects a coaching rule directly into your project

Alerts are capped at 2 visible by default to avoid clutter, with a "show more" toggle.

AI-Powered Deep Analysis (Optional)

Click "Analyse Now" for a comprehensive session review powered by your choice of:

Anthropic Claude (Sonnet 4.5 default)
OpenAI (GPT-4o)
Azure OpenAI

Returns an overall score (0–100), spider chart across multiple dimensions, and prioritised recommendations.

Session Management

Browse all workspace sessions with entry counts and file sizes
Switch between sessions with one click
Export session data as JSON
Works with both Claude Code CLI and Claude Code VSCode extension sessions

Getting Started

Install the extension
Open a workspace where you use Claude Code
AI IQ auto-detects your active session — look for the brain icon in the activity bar
Start a Claude Code session (CLI or extension) and watch the metrics update in real time

No configuration required for the heuristic engine. For AI-powered analysis, set your API key:

// Settings (Ctrl+,)
aiiq.apiKey: "sk-ant-..."        // Anthropic
aiiq.openaiApiKey: "sk-proj-..." // OpenAI
aiiq.azureApiKey: "..."          // Azure OpenAI

Or use environment variables: ANTHROPIC_API_KEY, OPENAI_API_KEY, AZURE_OPENAI_API_KEY.

Settings

Setting	Default	Description
`aiiq.autoDetect`	`true`	Auto-detect active Claude Code sessions
`aiiq.claudeDir`	`~/.claude`	Claude data directory
`aiiq.notifications`	`false`	Desktop notifications for critical alerts
`aiiq.alertSensitivity`	`medium`	Alert threshold: low, medium, high
`aiiq.analysisProvider`	`anthropic`	AI provider: anthropic, openai, azure-openai
`aiiq.analysisModel`	`claude-sonnet-4-5-20250514`	Model for deep analysis
`aiiq.showCosts`	`true`	Show cost estimates in metrics

Commands

AI IQ: Show Panel — Open the coaching panel
AI IQ: Analyse Now — Run AI-powered deep analysis
AI IQ: Switch Session — Pick a different session to watch
AI IQ: Export Session — Save session data as JSON
AI IQ: Clear Alerts — Dismiss all active alerts

Platform Support

Windows — Full support (tested)
macOS — Supported (session paths auto-detected)
Linux — Supported

Privacy

AI IQ reads Claude Code session files stored locally at ~/.claude/projects/. Your transcript data:

Never leaves your machine when using the heuristic engine (default)
Is sent to your configured AI provider only when you click "Analyse Now"
Is never stored, logged, or transmitted by AI IQ itself

No telemetry. No tracking. No data collection.

Built by AI First Partner