cordy 0.1.7

English · Русский

Hot-swap any model or provider mid-conversation. Edit files behind a permission gate. MCP, skills, sub-agents, and background jobs — in one fast, keyboard-driven TUI.

Cordy is a cross-platform terminal agent that talks to every major API family — OpenAI Chat Completions, OpenAI-compatible endpoints, Anthropic Messages, and the OpenAI Responses API — through one canonical model, so switching provider or model never loses your conversation. It edits files with an exact, diff-confirmed edit, runs a builtin toolset whose command output is compressed by a native token optimizer, and speaks the Model Context Protocol.

• Hot-swap models & providers mid-conversation — start on a local model, finish on a frontier one, context intact. ^P → pick a model, or /connect to add a provider.
• Every API family — OpenAI Chat, OpenAI-compatible (Ollama / vLLM / OpenRouter / Groq / …), Anthropic Messages, OpenAI Responses. Wire formats never leak past the adapter.
• Builtin tools — read write edit apply_patch multiedit grep glob ls bash todo web_search web_fetch process rewind, all behind a permission gate you can pre-approve with globs. apply_patch applies a multi-file, multi-hunk patch as one reviewed unit, matching context tolerantly so near-miss whitespace and smart quotes still land.
• Background jobs — run a dev server with bash background:true, then process to poll, wait on a regex, or kill the whole process tree.
• MCP, skills, sub-agents — connect MCP servers, load progressive-disclosure skills, and delegate work to isolated sub-agents via the task tool.
• Free web search — DuckDuckGo out of the box (no key), or Exa when EXA_API_KEY is set.
• Live cost & context HUD — tokens, $ cost, optimizer savings, context fill, background jobs and sub-agents in a side panel.
• OpenCode-inspired UI — command palette, prompt history, multiline input, sessions, a provider manager, eight themes, and full config hot-reload.

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/redstone-md/Cordy/main/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/redstone-md/Cordy/main/install.ps1 | iex

The scripts download the signed binary for your platform, verify its checksum, and drop cordy on your PATH.

With cargo — cargo install cordy

Prebuilt binaries — or grab the archive for your platform from the latest release, unpack, and run cordy.

From source (Rust 1.88+) — the default build is full-featured (MCP included):

git clone https://github.com/redstone-md/Cordy.git
cd Cordy
cargo build --release
# binary at target/release/cordy

Want a leaner binary without the MCP client? cargo build --release --no-default-features.

Point Cordy at any OpenAI-compatible endpoint via environment variables, then run it:

export OPENAI_API_KEY=sk-...
export CORDY_BASE_URL=https://api.openai.com/v1   # or any compatible endpoint
export CORDY_MODEL=gpt-4o-mini
cordy

…or skip the env vars and press ^P → /connect inside the app to add a provider through the wizard. Providers you connect are saved to ~/.cordy/config.toml, and the last one is restored on launch. All user state — config, keys, sessions, cache — lives under ~/.cordy.

Slash commands include /connect /providers /model /sessions /permissions /mouse /thinking /compact /goal and more — type / to autocomplete.

A goal is an objective the session keeps working on by itself. While it is active, each finished turn feeds the next one, so a long task runs unattended until it is done, out of budget, or stuck.

/goal fix the flaky auth test --budget 200k --cost 2.50 --turns 20
/goal                 # status: objective, tokens, elapsed
/goal edit            # load the objective back into the composer
/goal pause           # stop the loop, keep the goal
/goal resume          # back to work
/goal clear           # drop it

Budgets are the safety rail: whichever of tokens, dollars or turns runs out first flips the goal to limited by budget, and the model is told to wrap up rather than start new work. It stops on its own too — the agent marks the goal complete only after auditing the objective against the current worktree, or blocked after the same obstacle recurs three turns running. Esc or typing anything interrupts the loop; a resumed session waits for you before spending again. Defaults live under [goal] in the config, and the goal travels with the session (including forks).

~/.cordy/config.toml (merged with a project-level .cordy/config.toml). It is hot-reloaded — edits apply within a second, no restart. Secrets never live here; API keys go in the OS env or ~/.cordy/keys.json (written by /connect).

optimize = true
theme = "tokyonight"   # mono (default) · dark · tokyonight · catppuccin · gruvbox · nord · rosepine · light

# Fine-tune any role color on top of the theme
[colors]
accent  = "#7aa2f7"
surface = "#24283b"

# Autonomous goals: whichever cap is hit first ends the run
[goal]
enabled      = true
token_budget = 200000
cost_cap_usd = 5.0
max_turns    = 20

# Pre-approve commands so the agent stops asking
[permissions]
mode  = "ask"          # or "auto"
allow = ["bash:ls *", "bash:git *", "bash:cargo *"]
deny  = ["bash:rm -rf *"]

# A provider (secrets stay in env / keys.json, never here)
[[provider]]
name = "openai"
kind = "openai-chat"
base_url = "https://api.openai.com/v1"

# An MCP server (in the default build)
[[mcp]]
name = "browsermcp"
transport = "stdio"
command = "npx @browsermcp/mcp@latest"
enabled = true

src/
  core/       canonical model (ContentBlock/Message/WireEvent), agent loop, prompt, context,
              sessions, permissions, goals (autonomous loop), auth
  provider/   Provider trait + one adapter per API family (+ retry decorator)
  tools/      Tool trait, builtins, native output optimizer, sub-agents, background jobs
  skills/     progressive-disclosure skill loader
  agents/     sub-agent registry
  mcp/        MCP client (on by default; opt out with --no-default-features)
  config/     TOML load/merge, model & provider profiles
  tui/        ratatui MVU app — model, update, view, themes, markdown

Contributions are welcome — see CONTRIBUTING.md. Before opening a PR:

cargo fmt
cargo clippy --all-targets
cargo test

Released under the MIT License.