FAQ
Quick answers to the questions people ask most.
Does it work with my Claude Pro/Max subscription?
Yes — OAuth against your existing Pro/Max plan is the main path. No extra billing; same account you already pay for. You can also use an ANTHROPIC_API_KEY.
Is it really a drop-in for claude-code?
It targets the same workflow — a Claude coding agent in your terminal with the same auth — as a single native binary. It is Claude-only by design; if you need many providers, aider is the better fit.
Do I need Node or Python?
No. agentty is a single static C++26 binary. No Node runtime, no npm install, no Python, no Electron.
What platforms are supported?
Linux, macOS, and Windows — all built and tested daily. Prebuilt binaries ship for Linux (x86_64, aarch64) and Windows (x86_64); macOS builds from source in seconds.
How is it sandboxed?
Every shell/build call runs in bwrap (Linux) or sandbox-exec (macOS). The workspace is read-write, system libs read-only, and ~/.ssh / /etc / other projects are blocked. Windows runs unsandboxed for now.
Can I run it on a machine with no internet?
Yes. agentty airgap user@host relays traffic from your laptop over SOCKS5-over-SSH, with TLS pinned end-to-end. See the air-gap guide.
Where are my conversations stored?
As plain JSON, one file per thread, under ~/.agentty/threads/<workspace-hash>/. Safe to inspect, back up, or delete.
Is it stable / production ready?
It's pre-1.0 and moving fast, but the core loop, tools, streaming, auth, and persistence all work and get daily smoke testing on Linux. Treat it as a capable beta.
What license is it under?
MIT. Use it, fork it, ship it. See the license page.