whatisgithub

What is ccglass?

jianshuo/ccglass — explained in plain English

Analysis updated 2026-05-18

181JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A local proxy and dashboard that shows exactly what requests your AI coding assistant, like Claude Code or Codex, sends to the AI model behind the scenes.

Mindmap

mindmap
  root((ccglass))
    What it does
      Local proxy
      Request dashboard
      Traffic capture
    Tech stack
      Node.js
      npm package
      MCP tools
    Use cases
      Debug AI tool calls
      Inspect system prompts
      Track token cost
    Audience
      Developers
    Supported tools
      Claude Code
      Codex
      OpenCode

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 system prompt and tool list your AI coding assistant is using.

USE CASE 2

Debug why an AI coding tool chose a particular tool call by reviewing the full request history.

USE CASE 3

Estimate the dollar cost of a coding session by tracking tokens and cache usage per request.

What is it built with?

JavaScriptNode.jsMCP

How does it compare?

jianshuo/ccglasstaisly/agentimtonyjaa/ggemu-fishing-joy
Stars181179175
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Node.js 18 or newer, no other runtime dependencies for core features.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

ccglass is a developer tool that lets you see the exact requests your AI coding assistant sends to the AI model behind the scenes. It works with Claude Code, Codex, OpenCode, DeepSeek-TUI, and Kimi. Install it globally via npm, run one command, and it sets up a local proxy that sits between your coding tool and the AI service it talks to. A web dashboard opens in your browser showing every request in real time. The problem it solves is specific: these coding tools are built in ways that bypass the standard proxy settings you might use to inspect network traffic with other tools. ccglass takes a different approach. It redirects the tool to send requests to a local address first, then forwards them to the real API. Because the local hop is plain unencrypted HTTP, there is nothing to intercept at the TLS level. No certificate setup is needed. The dashboard shows the full system prompt, every message in the conversation history, the list of tools the model was given, token counts, cache usage, and an estimated cost per request in US dollars. A conversation flow view shows which tools the model chose to use and how results were fed back. A turn-to-turn diff view lets you compare two consecutive requests to see exactly what changed. You can also export any captured request as a readable text transcript, Markdown, JSON, or a HAR file (a standard format for web traffic recordings). When wrapping Claude Code specifically, ccglass can register its own query tools via MCP (a protocol for giving AI models access to external tools), so the AI assistant can look up the requests it just sent during the same session. All captured requests are saved to a local folder called .ccglass in your project directory. Authentication tokens in request headers are masked by default to avoid accidentally committing secrets. The tool requires Node.js 18 or newer and has no runtime dependencies for its core features. It is MIT-licensed.

Copy-paste prompts

Prompt 1
Show me how to install ccglass globally and point Claude Code through its local proxy.
Prompt 2
Explain how ccglass intercepts requests from coding tools without needing TLS certificates.
Prompt 3
Help me export a captured ccglass session as a Markdown transcript for a bug report.
Prompt 4
Walk me through using the turn-to-turn diff view to see what changed between two requests.

Frequently asked questions

What is ccglass?

A local proxy and dashboard that shows exactly what requests your AI coding assistant, like Claude Code or Codex, sends to the AI model behind the scenes.

What language is ccglass written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, MCP.

What license does ccglass use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ccglass to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ccglass for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.