# Agentty ADE: reliable L2 multi-agent orchestrator

> Source: <https://github.com/agentty-xyz/agentty>
> Published: 2026-07-19 04:31:36+00:00

Agentty is an **ADE (Agentic Development Environment) for structured, controllable
AI-assisted software development**. Built with Rust and [Ratatui](https://ratatui.rs),
and refined through its own day-to-day use, it brings agents, review, and iteration into
one focused terminal workflow.

```
npm install -g agentty
```

## 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
```

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](https://github.com/openai/codex)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](https://openai.com/policies/terms-of-use/).
OpenClaw documents ChatGPT/Codex subscription sign-in as the normal
[Codex harness](https://docs.openclaw.ai/plugins/codex-harness) path, and opencode
recommends ChatGPT Plus or Pro authentication for its
[OpenAI provider](https://opencode.ai/docs/providers/#openai).

- Claude (
`claude`

): install[Claude Code](https://github.com/anthropics/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](https://code.claude.com/docs/en/legal-and-compliance)
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](https://www.youtube.com/watch?v=RIkSlHgQYog) 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.0 or newer of the[Antigravity CLI](https://github.com/google-antigravity/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](https://antigravity.google/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](https://github.com/google-gemini/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](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-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.

```
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
```

The **Issues** tab uses the GitHub CLI to show open issues assigned to the authenticated
user in the active project. Press `Enter`

to load base issue details and the
description; comments are not loaded in this iteration. Install `gh`

and run
`gh auth login`

to enable it.

For sessions linked to a GitHub pull request or GitLab merge request, press `c`

in
session view to browse review comments read-only. General comments and inline threads
are listed on the left, with the selected conversation and attached current-diff context
on the right.

Documentation for installation and workflows is available at
[agentty.xyz/docs](https://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.

See [CONTRIBUTING.md](/agentty-xyz/agentty/blob/main/CONTRIBUTING.md) for contribution guidance.

Apache-2.0