Watchtower: A Local Proxy for Monitoring Claude Code API Traffic
What Watchtower Does
Watchtower is a local HTTP proxy combined with a real-time web dashboard. It intercepts all API traffic between Claude Code (or the Codex CLI) and their backend APIs. This allows developers to see every request, Server-Sent Events (SSE) stream, tool definition, system prompt, token usage, and rate limit in real time.
Key Features and Motivation
The tool was built using Claude Code itself. According to the creator, Claude Code typically sends 2-3 API calls per user message: one for quota checks, another for token counts, and then the actual streaming request. It also spawns subagents with completely different system prompts and smaller tool sets. The main system prompt alone is reported to be over 20,000 tokens. Normally, this internal communication is not visible to the user.
Setup and Usage
Installation is done via npm:
npm install -g watchtower-ai && watchtower-aiTo use it, run Claude Code while pointing it at the proxy by setting an environment variable:
ANTHROPIC_BASE_URL=http://localhost:8024 claudeThe dashboard interface opens in your browser at http://localhost:8025.
Project Details
The entire project—including the proxy server, provider detection, SSE parsing, and the dashboard UI—was built using Claude Code. It is released under the MIT license, is free and open source, and has no paid tiers or account requirements.
The creator states this tool is useful for developers who want to see reasoning traces, understand token consumption patterns, or learn how the agent harness works in order to build better AI agents themselves.
📖 Read the full source: r/ClaudeAI
👀 See Also
Spectral: Capture App Traffic to Generate MCP Servers for OpenClaw Agents
Spectral is an open-source tool that captures traffic from any application, analyzes it with an LLM, and generates a working MCP server, allowing OpenClaw agents to call the app's real API directly instead of relying on browser automation.
Telegram Bot for Claude Code CLI Control from Mobile
A developer built a Telegram bot that bridges to the Claude Code CLI, allowing control via mobile commands like /commit, /code_review, and /simplify. The bot auto-discovers custom skills, processes photos/documents/voice notes, and supports group chat sessions.
Tendril: A self-extending agent that builds and registers tools on the fly
Tendril is an agentic sandbox that autonomously discovers, builds, and registers tools. It starts with just three bootstrap tools and dynamically grows its capability registry without asking the user.
Learning-Kit: A Claude Code Plugin for Codebase Onboarding and Exploration
Learning-kit is a free Claude Code plugin that analyzes repositories to generate structured learning plans and interactive tutorials. It helps developers understand unfamiliar codebases before making changes, with configurable enforcement modes and progress tracking.