Agentty

agentty

AI pair programming in your terminal One static binary. Sub-millisecond startup. Any model.

Getting Started

curl -fsSL https://raw.githubusercontent.com/1ay1/agentty/master/install.sh | sh
cd your-project
agentty

First launch opens auth — OAuth (uses your Claude Pro/Max subscription) or paste an API key. Then type and hit Enter.

Features

⚡ Instant startup

Cold start under 1ms. No Node, no Python, no npm install. Just a static binary.

🔌 Any model

Claude, GPT, Groq, OpenRouter, Ollama, or any OpenAI-compatible endpoint. Switch live with ^P.

🛡️ Sandboxed by default

Every shell call runs inside bwrap (Linux) / sandbox-exec (macOS). File tools refuse paths outside your workspace.

🌐 Air-gapped mode

Run on a box with no internet. Your laptop relays the bytes over SSH with TLS pinned end-to-end.

🔧 Full tool suite

read · write · edit · bash · grep · glob · git · web · search_docs · task — each with a purpose-built widget.

🧠 Learns your codebase

Agent Skills + remember/forget memory. Teach it once, every session knows your conventions.

Providers

agentty                                    # Claude (default)
agentty --provider openai -m gpt-4o        # GPT
agentty --provider groq -m llama-3.3-70b   # Groq
agentty --provider ollama -m qwen2.5-coder # Local model
agentty --provider openrouter              # Any model via OpenRouter

--provider persists. Switch live in-app with ^P.

Keys

| Key | Action | Key | Action | |-----|--------|-----|--------| | Enter | Send | ^K | Command palette | | Esc | Cancel / reject | ^J | Thread list | | S-Tab | Cycle profile | ^P | Model picker | | Alt+Enter | Newline | ^N | New thread |

More

Installation options

# Debian / Ubuntu
curl -fsSLO https://github.com/1ay1/agentty/releases/latest/download/agentty_amd64.deb
sudo dpkg -i agentty_amd64.deb

# Arch
yay -S agentty-bin

# macOS
brew tap 1ay1/tap && brew install agentty

# Windows
scoop bucket add 1ay1 https://github.com/1ay1/scoop-bucket && scoop install agentty

# From source
git clone --recursive git@github.com:1ay1/agentty.git
cd agentty && cmake -B build && cmake --build build -j

Air-gapped hosts

agentty airgap --setup user@host   # first time: copies credentials
agentty airgap user@host           # every time after

Your laptop relays via SOCKS5-over-SSH. TLS pins on real upstreams — the network in between can't MITM you.

Inside Zed (ACP)

agentty speaks the Agent Client Protocol — the same protocol Zed uses for Claude Code. Add to Zed's settings:

{
  "agent_servers": {
    "agentty": {
      "command": "agentty",
      "args": ["acp"]
    }
  }
}

Agent Skills

Drop a SKILL.md anywhere under .agentty/skills/ or ~/.agentty/skills/ — it's live next turn. Compatible with Claude Code's .claude/skills/ format.

On codebases with internal DSLs or tribal conventions, agent accuracy jumps from ~20% to ~85% with curated skills (research).

Architecture

Pure-functional update loop: (Model, Msg) -> (Model, Cmd). View is Model -> Element, rendered by maya. Process management via posix_spawn + poll(2). File writes are atomic (write + fsync + rename).

Deep dive: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · [docs/RENDERING.md](docs/RENDERING.md)

License

MIT — see [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: 1ay1
• Source: 1ay1/agentty
• License: MIT
• Homepage: https://agentty.org

Install and usage instructions live in the source repository linked above.