CC Buddy is a native macOS app for managing and reviewing local Coding Agent CLI sessions. It does not run the agent for you; it turns histories already written by your CLIs into readable, searchable timelines. After a task finishes, you can trace its goal, decisions, tool calls, subagents, changes, failures, and final outcome. An optional local gateway is included for model API conversion.
CLI session histories ──▶ CC Buddy ──▶ browse · search · trace · export · review
Reads local histories from Claude Code, Codex CLI, Qoder CLI, Grok Build CLI, GitHub Copilot CLI, and Antigravity CLI.
- Reconstruct the run — render Markdown, thinking, tool calls and results, patches, images, recorded model/token metadata, and main/subagent threads.
- Find the moment — auto-discover histories, group by source and project, and search across sessions or inside one conversation.
- Manage the archive — rename, tag, star, filter, recycle, follow active sessions, and import compatible JSONL/ZIP transcripts. History roots are managed in Settings › Session locations.
- Pick it back up — reopen a session in Terminal, iTerm, Ghostty or Warp with the producing CLI's own resume flags; export raw session files/bundles (JSONL, ZIP, or DB) or portable HTML; hand the main and subagent transcripts to Claude or ChatGPT for analysis.
As a companion feature, the gateway accepts Anthropic Messages, OpenAI Chat Completions, and OpenAI Responses on both client and provider sides, passing through matching protocols or translating between them. It configures Claude Code and Codex with one click; other compatible clients can use the local endpoint manually. Around seventy provider presets ship built in, alongside custom and plugin-backed providers, with switching and model mapping.
The gateway binds to 127.0.0.1; inference requests still go to the provider you select.
CC Buddy 2.x supports Macs running macOS 13 or newer, Apple silicon and Intel alike. Download the signed universal DMG from Releases.
Version 2 is the native Swift/SwiftUI replacement and does not publish Windows or Linux builds. Legacy 1.x artifacts remain available on the Releases page, but those platforms do not receive the 2.x application or updater channel.
Homebrew:
brew install --cask ccbud/tap/ccbudNative development requires Xcode 26 and XcodeGen. Node.js is used by localization and release tooling.
git clone https://github.com/ccbud/ccbud.git && cd ccbud
brew install xcodegen
native/Scripts/fetch-bifrost.sh
xcodegen generate --spec native/project.yml --project native
xcodebuild -project native/CCBuddy.xcodeproj -scheme CCBuddy \
-destination 'platform=macOS,arch=arm64' buildSee native/README.md for the isolated unit/integration command and the
unique-bundle-ID UI test command. The latter keeps an installed CC Buddy process out of XCTest's
launch and termination scope.
Released under GPL-3.0.