# Add to your Claude Code skills
git clone https://github.com/tingly-dev/tingly-box
README.md
Announcement: Here is fault record. Please update to the latest version to resolve known issues. Thank you for your continued support.
Tingly Box coordinates AI models, optimizes context, and routes requests for maximum efficiency — with built-in remote control and secure, customizable integrations.
Key Features
Unified API – One mixin endpoint to rule them all, use what you like - OpenAI / Anthropic / Google, seamlessly bridge all of them with auto translation
Smart Routing, Not Just Load Balancing – Intelligently route requests across models and tokens based on cost, speed, or custom policies, not simple load balancing
Smart Context Compression – (Coming soon) Automatically distill context to its essential parts: sharper relevance, lower cost, and faster responses
Blazing Fast – Adds typically < 1ms of overhead—so you get flexibility without latency tax
Flexible Auth – Support for both API keys and OAuth (e.g., Claude.ai), so you can use your existing quotas anywhere
Visual Control Plane – Intuitive UI to manage providers, routes, aliases, and models at a glance
Client Side Usage Stats - Track token consumption, latency, cost estimates, and model selection per request—directly from your client
Remote Control - Control your AI agents remotely via IM bots (Slack, Discord, Telegram, DingTalk, Feishu). Interact with your agents from anywhere without direct server access
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
151,568
orchestration
Quick Start
Install
From npm (recommended)
# Install and run (auto service migration without any args)
npx tingly-box@latest
if any trouble, please check tingly-box process and port 12580 and confirm to kill them.
From source code
Requires: Go 1.25+, Node.js 20+, pnpm, task, openapi
# Install dependencies
# - Go: https://go.dev/doc/install
# - Node.js: https://nodejs.org/
# - pnpm: `npm install -g pnpm`
# - task: https://taskfile.dev/installation/, or `go install github.com/go-task/task/v3/cmd/task@latest`
# - shell: copy and run shell command in taskfile directly
git submodule update --init --recursive
# Build with frontend
task build
# Build GUI binary via wails3
task wails:build
MCP Web Tools – Local stdio MCP server for web_search / web_fetch
Philosophy
One endpoint, many providers – Consolidates multiple providers behind a single API with minimal configuration.
Seamless integration – Works with SDKs and CLI tools with minimal setup.
Contributing
By contributing to this repository, you agree that your contributions may be
included in this project under the MPL-2.0 and may also be used by Tingly Inc.
under separate commercial licensing terms.
See CONTRIBUTING.md and NOTICE for details.
How to Contribute
We welcome contributions! Follow these steps, inspired by popular open-source repositories:
Fork the repository – Click the “Fork” button on GitHub.
Clone your fork
git clone https://github.com/your-username/tingly-box.git
cd tingly-box
Create a new branch
git checkout -b feature/my-new-feature
Make your changes – Follow existing code style and add tests if applicable.
Run tests
task test
Commit your changes
git commit -m "Add concise description of your change"
Push your branch
git push origin feature/my-new-feature
Open a Pull Request – Go to the GitHub repository and open a PR against main.
