Claude Code and Codex Assist — History, Diff & Usage Analytics for VS Code, Cursor & more

Note: This is an unofficial extension and is not made by or affiliated with Anthropic, OpenAI, SST/OpenCode, xAI/Grok, or GitHub.

Browse your Claude Code, Codex, OpenCode, Grok, and GitHub Copilot chat history right inside VS Code — view file diffs, search across every conversation, track token usage and cost, and resume past sessions without leaving the editor. It doubles as a usage tracker: a single dashboard shows cost per model, quota burn-down, and weekly reset history across all your AI assistants. Ever wondered which AI conversation changed a file? The File Timeline is git blame for AI edits: pick a file, see every session and prompt that touched it, and open the exact diff.

🤖 Works with all five assistants:

• Claude Code — ~/.claude/projects/
• Codex — ~/.codex/sessions/
• OpenCode — ~/.local/share/opencode/
• Grok — ~/.grok/
• GitHub Copilot — Copilot CLI and VS Code chat sessions

Sessions from all five appear in one unified list with badges and logos that tell them apart. A built-in MCP server even lets the assistants share context with each other — continue your last Codex session from Claude Code, or ask Grok what a past Claude session changed.

🌐 UI languages: English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Deutsch | Français | Español

🎬 Feature Demos

🔍 Full-Text Search

Search every prompt and reply across thousands of sessions. Results are grouped by session with the matching message, project, and cost. The Advanced panel lets you pick who to search (all, you, or the assistant), how to match (any words, exact phrase, or regex), and whether to include tool output and subagent transcripts.

✅ Session Changes & Review

Every turn shows the files it touched with +/- counts, diff, undo, and reapply. Open Review Changes to see all file changes from a conversation in one place.

⏱️ File History Timeline

git blame, but for AI conversations. Open any file and the timeline shows every session that edited it — expand a session to see the exact prompt and its diff, across Claude Code, Codex, OpenCode, Grok, and Copilot.

💬 Conversation View

Rendered transcript with per-turn Turn changes cards, a context-window graph, cache hit rate, and cost. Resume in the terminal, the desktop app, or the Codex VS Code extension, or export to Markdown.

<img src="./assets/conversation-view.png" alt="Conversation view with per-turn file changes and resume targets" width="420">

📊 Quota Burn-Down & Activity

Live 5-hour and weekly quota cards for Claude, Codex, Fable, and Grok, burn-down charts that project when each window exhausts, an activity heatmap, and a day-by-day cost table.

<img src="./assets/account-quota.png" alt="Account tab with quota cards, burn-down chart, and activity heatmap" width="420">

📅 Weekly Digest

A rolling 7-day summary of sessions, tokens, cost, edits, and active days versus last week, split by tool and by project.

<img src="./assets/weekly-digest.png" alt="Weekly digest with totals, day-by-day tokens, and top projects" width="420">

📚 Unified Session Browser

Claude Code, Codex, Grok, OpenCode, Copilot, and Cursor sessions in one list, grouped by project, with per-model filters and cost per folder.

<img src="./assets/chat-history.png" alt="Sessions tab grouped by project with the model filter open" width="420">

🔌 ccassist MCP Server

A local MCP server lets Claude Code, Codex, Grok, OpenCode, and Cursor read your session history and continue each other's work.

<img src="./assets/history-mcp.png" alt="MCP tab listing the ccassist tools available to CLI agents" width="420">

📍 Quota in the Status Bar

Claude, Fable, Codex, and Grok percentages are always visible; hover to see every window with its reset time.

<img src="./assets/usage-quota-statusbar.png" alt="Status bar quota indicator with hover popup" width="555">

🌟 Features

Sessions & History

• Unified history for Claude Code, Codex, OpenCode, Grok, and GitHub Copilot, organized by project with current-project detection
• Quick actions & keyboard navigation — pin, resume, or delete from a session row; move with arrow keys, open with Enter, remove with Delete
• Project context menu — right-click a project header to pin it, hide it, reveal it in your file manager, or open it in a new window
• Hide individual sessions — declutter the list without deleting anything; hidden sessions collect in the Hidden tab, grouped by project, with one-click unhide or bulk hide via multi-select
• Rich transcript rendering — markdown with syntax-highlighted code, Mermaid diagrams with zoom and export, and LaTeX math typeset offline with KaTeX (copying rendered math gives you the TeX source back)
• Live search filter to narrow the list as you type
• Model filters, pinned projects, and pin & rename help keep large histories tidy and easy to scan
• Resume any conversation in the terminal, desktop app, or VS Code — or copy the command to run elsewhere
• Fork a conversation from any message to explore an alternative without touching the original Pro
• Format converter between Claude and Codex, resuming straight into the target assistant Pro
• Auto-refresh keeps recent sessions up to date while they're still changing
• Cleaner history list UI with a more minimal visual style that keeps long session lists easier to scan

Archiving & Markdown Sync

• Session Archive — Claude and Codex eventually clean up old transcripts; archiving keeps a full-fidelity copy safe in its own folder, browsable from a dedicated Archived tab. Viewing and restoring archived sessions is always free. Pro to archive
• Markdown export of full sessions with customizable metadata Pro
• Markdown sync — exported sessions can be committed to git, moved between devices, imported back with file changes intact, or resumed as a native session (even across operating systems)
• Bulk actions — select multiple sessions to export or delete them together Pro

File Changes & Diffs

• GitHub-style diffs with syntax highlighting and multi-file support
• Review Changes view — see every file change from a conversation in one place
• Apply, undo, or reapply changes to your workspace with one click
• File history timeline — git blame for AI conversations: the timeline auto-follows the active editor and lists every session that edited the file, then drill into any session to read the exact prompt and open its diff (or right-click a file to open the timeline)

Search

• Direct file search — every search scans your session files directly; nothing is copied into a separate index, and results show how many files were scanned
• Advanced panel — one click next to the search bar opens selectable options: search everyone, only your prompts, or only the assistant's replies; match any words, an exact phrase, or a regular expression
• Tool output and subagent search — toggle in tool inputs/results and subagent transcripts to find details that never appear in the main chat messages
• Session-grouped results with cost, token, and message counts, plus highlighted matches

ccassist MCP Server — share context between assistants

• Local MCP server — the extension can host a lightweight local MCP server so Claude Code, Codex, Grok, OpenCode, and Cursor can query your session history from inside any of them (loopback only, off by default)
• Continue work across tools — say "continue my last Codex session" in Claude Code (or vice versa) and the agent pulls a distilled handoff block: recent turns, session summary, and what changed
• One-click setup — run Set up ccassist (MCP + Skill) from the side panel's MCP page or the Command Palette; it registers the server with each CLI and installs a ccassist skill that teaches agents when and how to use it
• Seven tools — search_sessions, list_recent_sessions, get_context, and get_session for finding and loading past work, plus grep_sessions (literal transcript scan including tool outputs), get_session_changes (per-file summaries or reconstructed diffs), and get_file_sessions (which sessions touched a file) Pro
• Private by design — everything stays on your machine; the server binds to localhost only, and a workspaceOnly setting can restrict it to sessions from the current workspace

Analytics & Cost Tracking

• Dashboard with usage statistics, activity timelines, and cost trends
• Quota tracking — live Claude/Codex quota cards, burn-down chart, weekly reset history, and weekly summary, with per-model breakdowns including Sonnet, Opus, and Fable where available
• Model usage charts to show which models are driving your activity and cost over time
• Detailed cost analysis across all supported Claude, OpenAI, OpenCode, Grok, and Copilot models, including cache-token insights
• Per-session analytics — context window usage over time (how full the context got, turn by turn), compaction events marked on the timeline, peak context vs. the model's limit, and cache-miss turns
• Status bar quota indicator with quick access to the dashboard

💎 Pricing

Free for everyday use. A few advanced features require Pro.

| | Free | Pro | |---|---|---| | Browse recent sessions | ✓ (last 7 days) | ✓ (unlimited) | | Search, diffs, dashboard | ✓ (recent) | ✓ (unlimited history) | | File timeline | ✓ (last 3 days) | ✓ (all sessions) | | Markdown export & bulk actions | — | ✓ | | Session archiving | — | ✓ | | Session forking & format conversion | — | ✓ | | ccassist MCP server | ✓ (last 7 days, core tools) | ✓ (full history + grep/diff tools) | | Devices | 2 | 5 |

See ccassist.dev for current pricing and refund policy.

🔒 Privacy

Chat content stays on your machine — the extension reads supported local assistant history folders and stores everything in a local SQLite database. You can verify with any network proxy: no chat text, file content, or diffs are ever sent.

What is sent by default: an anonymized device ID, OS/extension version, and aggregated usage counters (e.g. "session opened", "search ran"). Error reports include error messages and stack traces, never chat content. Both can be turned off in extension settings (enableErrorReporting, enableUsageStatsSharing).

🚀 Getting Started

Prerequisites: VS Code 1.80.0+ and an existing history from Claude Code, Codex, OpenCode, Grok, and/or GitHub Copilot.

1. Install from the VS Code Extensions marketplace
2. The extension auto-detects your Claude, Codex, OpenCode, Grok, and Copilot history
3. Click the CCAssist icon in the Activity Bar to start browsing, or press Ctrl+Shift+Q to open the side panel

Click any session to see the conversation and its file changes, use File Changes for a commit-style diff summary, and open the Dashboard tab for cost and quota analytics.

⌨️ Commands & Shortcuts

Open the Command Palette (Ctrl+Shift+P) and search for CCAssist — refresh sessions, open the dashboard, refresh API usage quota, open the side panel, and more.

| Shortcut | Action | |----------|--------| | Ctrl/Cmd+Shift+] | Next file change | | Ctrl/Cmd+Shift+[ | Previous file change | | Ctrl/Cmd+Shift+Q | Open side panel | | Ctrl+Alt+; | Recent file changes (quick pick) |

Additional actions (show diff, apply changes, open file, view file changes, show in timeline) are available via right-click context menus.

⚙️ Configuration

Access via Settings → Extensions → Claude Code Assist, or search "Claude History" in VS Code settings. Useful options include:

• **`claude-history.claudeDirectory