explaingit

thevibeworks/cctrace

Analysis updated 2026-05-18

3TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A local tool that shows exactly what your AI coding agent, like Claude Code or Codex, sends and receives over the network in a live browser dashboard.

Mindmap

mindmap
  root((cctrace))
    What it does
      Traces agent traffic
      Live web UI
      Replays sessions
    Tech stack
      TypeScript
      Bun runtime
      TLS proxy
    Use cases
      Debug agent requests
      Security auditing
      Session replay
    Audience
      Developers
      Security reviewers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Inspect the exact prompts, tool calls, and token usage your coding agent sends each turn.

USE CASE 2

Audit which external hosts your AI coding agent contacts for security or privacy review.

USE CASE 3

Replay a past coding agent session step by step to debug an unexpected response.

USE CASE 4

Capture OAuth and usage/credit requests that other tracing tools miss.

What is it built with?

TypeScriptBunOpenSSL

How does it compare?

thevibeworks/cctrace000madz000/payload-test-api-route-handleraliansari22/pdfclear
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Bun and openssl installed, plus the coding CLI you want to trace.

In plain English

cctrace is a tool that lets you watch exactly what your AI coding assistant is sending and receiving behind the scenes. It works with Claude Code, Codex, Grok, and Kimi Code, and it shows you every network request those tools make in a live browser window while you use them normally. The reason this exists is that modern coding agents like Claude Code now ship as compiled programs rather than plain JavaScript, which broke older tracing tools that worked by hooking into the code directly. Instead, cctrace sits between your agent and the internet as a local proxy that decrypts and reads the encrypted traffic for the services it is watching, using a security certificate it generates on your own machine. Any traffic to services it is not specifically watching, like downloading packages from npm or GitHub, passes through untouched without being read. What you get is a browser dashboard that shows every request your agent makes, including ones other tools miss, like login and usage or billing information, not just the main chat messages. It reconstructs full conversation sessions, including branching subagent tasks and model switches, and lets you replay a past session step by step. Every session is also saved to a file on your computer that you can reopen later, and sensitive information like passwords and API keys is automatically hidden before anything is saved to disk. To use it you need Bun, a JavaScript runtime, plus the openssl command line tool and whichever AI coding CLI you want to trace already installed. You install cctrace itself with a single command, then run it before your normal coding agent command, for example typing cctrace instead of claude, and a browser tab opens automatically showing the live traffic. Nothing about how it works involves any cloud service or account, everything stays on your own computer.

Copy-paste prompts

Prompt 1
Help me install cctrace with Bun and run it in front of Claude Code.
Prompt 2
Explain how cctrace's TLS-intercepting proxy captures OAuth and usage requests that a base-URL proxy would miss.
Prompt 3
Show me how to use cctrace view to reopen and replay a saved trace file.
Prompt 4
Walk me through cctrace's --capture-external and --intercept-host options for tracing extra hosts.

Frequently asked questions

What is cctrace?

A local tool that shows exactly what your AI coding agent, like Claude Code or Codex, sends and receives over the network in a live browser dashboard.

What language is cctrace written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, OpenSSL.

How hard is cctrace to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cctrace for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.