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
Atoo Studio: Open-Source Workspace for Managing Multi-Project Claude Code Workflows
Atoo Studio is an open-source workspace built to address terminal and tab chaos when using Claude Code across multiple projects. It introduces session forking like Git branches and allows continuation across Claude Code, Codex CLI, and Gemini CLI.
Simplifying OpenClaw Hosting: BestClaw Keeps SSH and User-Friendly Functionality
BestClaw emerges as a straightforward solution for OpenClaw hosting, balancing ease of use with crucial SSH access, as discussed on r/openclaw.
Visual Prompting Framework Replaces Text Prompts with Single Image for Claude AI
The Carrying Capacity Principle v9 is a bidirectional structural framework that uses a single flowchart image instead of text prompts for Claude AI. It provides structural diagnosis or generative construction plans based on system parameters or goals.
PaperclipAI: Open-source orchestration for zero-human companies
PaperclipAI is an open-source orchestration framework designed for fully automated companies. The project gained 14,000 GitHub stars in its first week of existence.