agentty-xyz/agentty
Agentic Development Environment (ADE) in your terminal - agentty-xyz/agentty
27 stars · 2 forks · 0 watchers
README
Agentty ADE
Agentty is an ADE (Agentic Development Environment) for structured, controllable AI-assisted software development. Built with Rust and Ratatui, and refined through its own day-to-day use, it brings agents, review, and iteration into one focused terminal workflow. Installation · Supported CLI Agents · Usage · Documentation · Contributing · License
Installation npm (recommended, supports auto-update) npm install -g agentty Other methods
npx (run without installing) npx agentty
Shell curl --proto '=https' --tlsv1.2 -LsSf https://github.com/agentty-xyz/agentty/releases/latest/download/agentty-installer.sh | sh
Cargo cargo install agentty
Supported CLI Agents Agentty currently supports Codex, Claude, Antigravity, and Gemini. Install and authenticate at least one provider CLI before starting a session:
Codex (codex, recommended; supports subscription usage): install the Codex CLI and run codex login.
Note Codex is the recommended CLI agent for Agentty when you want subscription-backed usage. Codex supports signing in with ChatGPT for subscription access, including in the CLI, and Agentty uses the Codex app-server integration surface. Usage remains subject to the OpenAI Terms of Use. OpenClaw documents ChatGPT/Codex subscription sign-in as the normal Codex harness path, and opencode recommends ChatGPT Plus or Pro authentication for its OpenAI provider.
Claude (claude): install Claude Code and run claude auth login.
Warning For Agentty usage through claude -p, use API key authentication through Claude Console or a supported cloud provider instead of a Claude Free, Pro, or Max subscription sign-in. Anthropic's Claude Code legal and compliance docs describe subscription OAuth as intended for ordinary use of Claude Code and native Anthropic applications, while developer integrations should use API keys or supported cloud providers. Theo's explanation video discusses the same uncertainty, but commentary does not guarantee that subscription-backed usage is safe for third-party tool invocation.
Antigravity (agy): install version 1.1.7 or newer of the Antigravity CLI and run agy to sign in when prompted.
Warning For Agentty usage through agy --print, use authentication backed by a Google Cloud project or an API key when available for your Antigravity setup, rather than a Google Account subscription sign-in. The Antigravity terms do not yet clearly describe how subscription access applies when agy --print is invoked by third-party tools.
Gemini (gemini): install the Gemini CLI and authenticate with an API key or Vertex AI.
Warning "Sign in with Google" (Google Account OAuth) no longer works for the Gemini CLI after Google's transition of the Gemini CLI to the Antigravity CLI. API key (GEMINI_API_KEY) and Vertex AI authentication still work, so use one of those for the Gemini backend, or use the Antigravity (agy) backend instead.
Agentty uses each provider's official non-interactive CLI or app-server surface (claude -p, agy --print, codex app-server, or gemini --acp) after you authenticate with that provider's CLI. It does not implement OAuth flows, read provider OAuth tokens directly, or call private provider APIs. You are responsible for choosing an authentication method that is permitted for your account, plan, and usage pattern. Usage agentty # Launch with auto-update enabled (default) agentty --no-update # Launch without automatic updates agentty --help # Show supported command-line options agentty --version # Show the installed Agentty version Documentation Documentation for installation and workflows is available at agentty.xyz/docs. Warning Agentty is in active development. While releases follow Semantic Versioning, the current 0.y.z series may still introduce breaking changes between releases as workflows, integrations, and safeguards evolve. Always review and verify the changes Agentty proposes or applies in your repositories before you rely on them.
Contributing See CONTRIBUTING.md for contribution guidance. License Apache-2.0