Coddy：跨终端与编辑器的AI智能体

General-purpose agent in one static Go binary: console TUI, ACP server for editors, OpenAI-compatible API with embedded web UI, Telegram …

A general-purpose agent in one static Go binary. A console TUI, an ACP server for editors, an OpenAI-compatible API with an embedded web UI, a Telegram gateway, a cron scheduler, a swarm relay for fleets of nodes and a remote mode, all over the same sessions. ReAct loop, filesystem and shell tools, MCP, rules, skills, subagents, hooks, background tasks, long-term memory, context compaction and project trust for what arrives with a checkout. Desktop (1920×1080) Mobile (390×844) Coddy is a harness: the same agent core is reachable from a terminal through the console TUI, from an editor over the Agent Client Protocol, from a browser or any OpenAI client over HTTP, from Telegram through the messenger gateway, and from cron through the scheduler. Every surface shares the sessions under ~/.coddy, so a conversation started in a chat is live in the browser and can be continued in either. It runs in scratch and distroless images with a read-only root filesystem, needs no runtime, and is built for fleets of containers as much as for one laptop. Install curl -fsSL https://coddy.dev/install.sh | bash irm https://coddy.dev/install.ps1 | iex The installer puts coddy on PATH, creates ~/.coddy/config.yaml from the release config.example.yaml when it is missing and, on Linux and macOS, installs the man page and the shell completions. Every release also publishes .deb and .rpm packages, a Homebrew cask in the tap coddy-project/homebrew-coddy-agent, archives for Linux, macOS, Windows and Android under Termux, and the image ghcr.io/coddy-project/coddy-agent for docker compose up -d. The packages and the cask recommend tmux, for a console session that outlives the terminal, without installing it. Details for each route are in Install and Docker; building from source is make build TAGS="http ui scheduler memory cli gateway swarm metrics browser" after git clone, see Build from source. On macOS, Homebrew installs it from Coddy's own tap and brew upgrade follows the releases: brew install coddy-project/coddy-agent/coddy Then give it a model. The quickest way is the console itself: run coddy and type /login, which signs in to NeuralDeep (/login codex, /login devin or /login opencode for the others) and writes the provider and every model it serves into ~/.coddy/config.yaml (Console). Or put a provider key into ~/.coddy/config.yaml, or export OPENAI_API_KEY and let the defaults pick it up: providers: - name: openai type: openai api_key: "${OPENAI_API_KEY}" models: - model: "openai/gpt-6.1-sol" max_tokens: 1050000 reasoning_default: high agent: model: "openai/gpt-6.1-sol" coddy -t checks the file and coddy --dry-run probes what it points at. Anthropic, NeuralDeep, ChatGPT sign-in through the Codex backend, a Devin account signed in through the browser (Devin), Ollama, llama.cpp and any other OpenAI-compatible server are covered in Configuration. The first five minutes on every surface are in Quickstart; upgrades are coddy update -y, which ends with the release notes of every version it skipped over (Update). Surfaces Surface Start it What you get Guide Console coddy A terminal chat with streamed tool calls, permission prompts, a model picker, !! for a local shell, coddy -c to continue, coddy -p "..." for one-shot answers, `git diff coddy -p "review"andcoddy -i brief.md` for piped data and long prompts Web UI and HTTP API coddy serve The embedded single-page app on http://127.0.0.1:12345/, OpenAI-compatible /v1/* endpoints and the /coddy REST surface, Swagger at /docs/ Web UI, HTTP API, video Editors coddy acp Zed, VS Code, Obsidian and scripts as ACP clients, with Coddy's modes, models, permissions and skills in the editor's composer Editors, Zed video, VS Code video Telegram coddy serve with gateways.telegram.enable A bot with per-user sessions, access levels and group isolation; the same chat is live in the web UI Telegram gateway Pachca coddy serve with gateways.pachca.enable A Pachca (Пачка) integration bot for direct chats, groups and threads; reads its events history, so no public address is needed Pachca gateway Scheduler coddy serve with scheduler.enable Cron jobs as Markdown files, each run a session of its own Scheduler Swarm coddy serve with swarm.enable A relay that lists and reaches many Coddy nodes, including ones that can only dial out Swarm, video Metrics coddy serve with metrics.enable A Prometheus exporter on a port of its own: provider calls and tokens, turns, background tasks and the session disk, with alert rules for the common failures Monitoring Remote coddy --remote host:port The console, an editor or the browser driving a coddy serve on another machine Remote mode coddy serve runs whatever config.yaml enables in one process. On Linux, coddy serve install runs it as a systemd user service of your account, working in ~/Coddy (coddy serve uninstall removes it); elsewhere coddy serve --daemon keeps it running in the background with status, stop and restart (coddy serve and the daemon). What it does Your own browser: the chats work in your Chrome, Yandex Browser or Firefox through the Coddy for Browser extension - open tabs, read pages, click, type, take screenshots and move files - in the tab groups you share, after you approve each website; its side panel is the web UI next to the page, and a console, an editor or another node of the swarm reaches the same browser through its home server (Coddy for Browser). Three operating modes: agent with every tool, plan for planning and text files, ask for read-only research, switched from any surface (Operating modes). Rules and project files: the first of .coddy/rules, .agents/rules, .cursor/rules, .claude/rules and .codex/rules that holds rules, so a mirror kept for another agent is not loaded twice, and nested AGENTS.md are picked up as the agent works without moving the cached system prompt; your own ~/.coddy/AGENTS.md, ~/.coddy/DESIGN.md and ~/.coddy/rules apply in every workspace (Rules and instructions). Skills: SKILL.md packs become slash comman