ThinkWatch-Lite README

The project's README from github.com/ThinkWatchProject/ThinkWatch-Lite. As one markdown file: README.md.

ThinkWatch Lite

Tauri 2 React 19 License: MIT macOS Windows Linux

ThinkWatch Lite

English | 中文

A local gateway for Claude Code, Codex and other AI clients, on macOS, Windows and Linux. Each client is connected once; after that, upstreams and models change without touching its configuration. Every request is recorded with its cost and route; the API keys in it can be replaced before it leaves the machine, and dangerous tool calls a relay slips into an answer can be cut off before the client runs them.

The overview for the last seven days: tokens, cost and requests against the seven days before, with the estimated part of the cost and the unpriced requests stated; a trend chart stacked by model with the periods that had failures marked; and the models ranked by tokens and cost

Highlights

The security log: credentials replaced before a request left, one of them matched by a custom rule; a download-and-run tool call cut off; and hidden characters, a delete command and an injected instruction recorded. Each entry names the key, client, model and upstream of its request

Install

Platform Install
macOS 12 or later, Apple silicon brew install --cask thinkwatchproject/tap/thinkwatch-lite, or ThinkWatch-Lite-<version>-arm64.dmg
Windows 10 21H2 or later, x64 ThinkWatch-Lite-<version>-x64-setup.exe
Windows 10 21H2 or later, ARM64 ThinkWatch-Lite-<version>-arm64-setup.exe
Linux, x86_64 or aarch64 curl -fsSL https://github.com/ThinkWatchProject/ThinkWatch-Lite/releases/latest/download/install.sh | sh, or ThinkWatch-Lite-<version>-<arch>.AppImage

The gateway, ThinkWatch Core, ships inside the app. The app is not signed by Apple or Microsoft, so the first launch needs one extra step; Install and update covers it, along with how updates arrive. The interface is in English and Simplified Chinese, and the app updates itself (a Homebrew installation updates through Homebrew).

Documentation

Build from source

pnpm install
bash src-tauri/scripts/fetch-core.sh
pnpm tauri dev

fetch-core.sh downloads the twcore release that Cargo.lock pins into src-tauri/resources/. See CONTRIBUTING.md for the layout of the repository and the checks to run before opening a pull request.

License

MIT. See LICENSE.

ThinkWatch-Lite (ThinkWatchProject/ThinkWatch-Lite)

monitoring
Searching Database…

What is this?ThinkWatch Lite is a local gateway that sits between AI coding clients (Claude Code, Codex, and others) and their upstream providers, letting you switch providers and models without reconfiguring each client, while tracking request cost and blocking malicious tool calls.
Is this a cloud service or does it run on my own machine?It's a desktop app with a system-tray icon; the gateway (ThinkWatch Core) ships bundled inside the app. The core can also be run remotely on a Linux server, with the app connecting to it over an encrypted control channel.
How do I install it and connect my AI clients to it?Install via Homebrew cask on macOS, a Windows .exe installer, or a curl script/.AppImage on Linux. Supported clients like Claude Code, Codex, Zed, and Aider are then pointed at the gateway in one step, with the config change previewed and the original file backed up for easy restore.
Do I still need my own provider API keys?Yes — you bring your own upstream accounts, whether API keys, Amazon Bedrock, ChatGPT, Z.ai, relays like OpenRouter, or local models, and the gateway converts between the Anthropic, OpenAI, and Gemini API formats as needed.
Is the installer ready to use right out of the box?Not entirely: the app isn't signed by Apple or Microsoft, so the first launch needs one extra manual step documented in the install guide; after that it updates itself (or via Homebrew if installed that way).
Does a relay ever see my real API keys?No — outbound redaction swaps API keys, private keys, JWTs, connection-string passwords, and other sensitive values for placeholders before a request leaves your machine, so the relay never holds the real credentials.
What does the 'upstream check-up' feature do?It compares each upstream serving the same model against the others, flagging answers that name a different model, report input tokens well above or below the norm, or show low prompt-cache reads, with sample sizes included for context.
Can it scan my MCP servers and skills for risks?Yes, it lists the MCP servers of thirteen clients side by side, marking third-party servers, and scans client configuration, skills, hooks, and project instructions for hidden characters, prompt injection, dangerous commands, and overly broad permissions.
Can I run the core on a remote server instead of locally?Yes, the gateway core can run on a Linux server while the desktop app on your laptop connects to it over an encrypted control channel.
Which AI clients are supported out of the box?Claude Code, Claude Desktop, Codex, opencode, Pi, oh-my-pi, Grok Build, Qwen Code, Hermes Agent, Zed, Aider, and DeepSeek Harness are configured automatically in one step; Cursor, Continue, and Antigravity CLI need manual setup following provided instructions.
Size
36.7 MB
Stars
824
Age
1mo
Commits · 90 Days