lis186

lis186 / ccxray

Public

X-ray vision for AI agent sessions — a transparent HTTP proxy and dashboard for Claude Code

92
14
100% credibility
Found Apr 04, 2026 at 68 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

ccxray is a zero-config tool that intercepts and visualizes all interactions between an AI coding agent and its service provider, offering real-time dashboards for timelines, costs, usage analytics, and system prompt tracking.

How It Works

1
🔍 Discover the AI spy tool

You hear about ccxray, a simple viewer that lets you peek inside your AI agent's black box to see its thoughts, spending, and hidden instructions.

2
🚀 Start the viewer

With one easy command, you launch the spy tool and it opens a dashboard in your browser automatically.

3
🔗 Point your AI through the spy

You tell your AI helper to send its messages through the viewer by setting a quick connection option.

4
💬 Chat with your AI normally

You continue talking to your AI agent just like always, while it secretly records everything behind the scenes.

5
📊 Watch the magic unfold

In real-time, the dashboard reveals your agent's thinking steps, exact costs, tool uses, and even secret instructions with colorful timelines and charts.

6
🛡️ Pause and tweak if needed

Optionally pause requests to edit messages, tools, or prompts before sending, giving you full control.

✅ Master your AI agent

You now fully understand what your AI is doing, track spending, spot changes, and optimize for better results without surprises.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 68 to 92 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is ccxray?

ccxray gives you x-ray vision ai for Claude Code sessions—a zero-config JavaScript HTTP proxy that intercepts every API call to Anthropic, logging requests and responses as JSON while serving a real-time dashboard on the same port. Run `npx ccxray claude` to launch Claude Code through it automatically, revealing black-box internals like system prompts, tool call costs, thinking durations, and 200K-token context breakdowns. It's x ray vision app for agents, turning opaque AI behavior into a glass box without needing your API key.

Why is it gaining traction?

Unlike basic loggers, ccxray's dashboard delivers live timelines of agent thinking blocks, session heatmaps with burn rates and ROI calcs, and auto-diffing system prompts across Claude Code versions—spot changes like x ray panel github updates instantly. The proxy is fully transparent, grouping turns by project dir with token accounting (input/output/cache), and supports Docker for easy x ray download github-style deployment. Devs hook on the one-command setup that proxies existing sessions via `ANTHROPIC_BASE_URL`.

Who should use this?

AI agent builders debugging Claude Code tools, like Bash or MCP calls failing silently. Cost-conscious devs tracking Anthropic spend in long sessions, or teams monitoring context bloat in multi-turn agents. Perfect for x ray vision for grippers in production prototypes where visibility beats guesswork.

Verdict

Grab it now if you're deep in Claude Code—early 18 stars and 1.0% credibility score scream alpha, but multilingual READMEs, MIT license, and Docker make it dead simple to eval. Polish tests and scale the dashboard for prod use.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.