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.
- Embedded tgrep, without a conversation SQLite database searches independently compressed file packs. Queries never wait for index preparation: direct block search returns verified results while tgrep prepares in the background, then narrows subsequent searches. Exact Unicode verification preserves snippets, message positions and occurrence counts. The search palette reports real progress and latency. Architecture and real-history measurements.
- Apple Neural Engine through Core ML powers optional offline semantic ordering of the first 32 results for English and code queries. A bundled 22.6 MB MiniLM weight file needs no account or download. Keyword results appear first and remain available while the model prepares; disabling smart ordering restores their original order. Intel uses CPU inference, and non-Latin queries keep keyword order.
On an Apple M4, Core ML's compute plan preferred ANE for 147 of 155 reported operations. A warm new-query rerank with three cached candidates took a median 0.774 ms versus 1.836 ms on CPU in the recorded run. The interface distinguishes anticipated placement from hardware-utilization telemetry. See model details, limitations and reproducible measurements.
A floating navigation rail, layered search palette, quieter transcript cards and focus reading bring the library, conversation and inspector into a clearer workspace. Native glass is used on macOS 26+, with material or opaque fallbacks for earlier systems and accessibility preferences. Motion respects Reduce Motion; surfaces respect Reduce Transparency and Increase Contrast.
Press ⌘K to search, ↑ / ↓ to choose a result and Return to open it. ⌘⇧S toggles focus reading, ⌘1–6 switches workspaces, ⌘R refreshes the conversation index and ⌘, opens Settings.
The redesign follows a macOS 27 design direction using available macOS 26 APIs behind availability checks. It does not require macOS 27 or claim validation on that OS.
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, XcodeGen, Python 3 and a current Rust stable toolchain installed through rustup. Node.js is used by localization and release tooling. End users do not need these tools.
git clone https://github.com/ccbud/ccbud.git && cd ccbud
brew install xcodegen
native/Scripts/fetch-bifrost.sh
bash native/Scripts/build-tgrep.sh
python3 native/Scripts/verify-semantic-model.py
xcodegen generate --spec native/project.yml --project native
xcodebuild -project native/CCBuddy.xcodeproj -scheme CCBuddy \
-destination 'platform=macOS' buildThe helper scripts build for the current Mac; release builds bundle both arm64 and x86_64. No local tgrep checkout is required: Cargo pins the upstream revision and dependency lockfile.
Every push to main, including PR merges and direct pushes, starts the official release pipeline. No manual tag is needed. The workflow creates an immutable snapshot of that exact source commit with only synchronized version-field changes, allocates the next patch version, and pushes an annotated tag. It does not write bot version commits back to main.
The same workflow then runs shared and native unit/UI tests, builds the universal app, signs it with Developer ID, notarizes it with Apple, and publishes a complete GitHub Release containing the DMG, updater archive, signature, and latest.json. Failed checks leave the release unpublished; rerun the failed Actions jobs to resume.
Retries reuse the source commit's existing tag. Consecutive pushes queue serially (GitHub permits up to 100 pending runs); a late older source cannot replace the latest updater channel or Homebrew cask. Explicit vX.Y.Z tag pushes remain supported. See the release workflow.
See the native build and test guide for universal builds, isolated unit/integration tests and UI tests with a separate bundle identifier. The architecture guide maps the native modules, data flow and compatibility boundaries.
Released under GPL-3.0.