Runtime & 集成 Integrations
CodeWhale is more than a terminal agent — it is a local control plane you can embed into your existing workflow through multiple protocols and integrations.
The Runtime API binds 127.0.0.1 by default. No hosted relay. No cloud dependency. Your data, your model, your control.
All Runtime API routes (/v1/*) require a Bearer token. Set CODEWHALE_RUNTIME_TOKEN env var or auth_token in config.toml.
Tool approvals, shell authorization, sandbox policies, and network access are all user-controlled and cannot be bypassed remotely.
CodeWhale speaks standard HTTP/SSE, JSON-RPC, and ACP — compatible with any client or platform.
HTTP / SSE Runtime API
Full local HTTP + Server-Sent Events runtime API on 127.0.0.1:7878. Create threads, stream turns, manage background jobs, and control approval decisions — all from any HTTP client or the bundled mobile page.
ACP (Agent Communication Protocol)
Open IETF-standard protocol surface for agent-to-agent communication. CodeWhale speaks ACP natively so external agents, tools, and platforms can discover and interact with running sessions.
MCP (Model Context Protocol)
Connect CodeWhale to external tools and services via MCP servers over stdio or HTTP/SSE. Pre-configured servers include filesystem, Git, SQLite, and popular SaaS platforms.
VS Code Extension ↗
Open-source VS Code extension that embeds CodeWhale as a side-panel agent. Run codewhale inside your editor with full workspace context.
Telegram Bridge ↗
First-party Telegram bot bridge. Start a headless CodeWhale session, then chat with it from any Telegram client — approvals, tool results, and completions surface inline.
Feishu / Lark Bridge ↗
First-party Feishu / Lark bot bridge. Chat-native agent loop inside your Feishu workspace with approval cards, session linking, and audit trail.
Weixin Bridge (实验性) ↗
Experimental Weixin / WeChat bridge. Receive agent completions and approvals inside WeChat; early-stage and not recommended for production deployments.
Detailed implementation docs: docs/RUNTIME_API.md · ACP Registry