Installation

Install Agentty, launch your first session, and review generated changes.

agentty is an ADE (Agentic Development Environment) for structured, controllable AI-assisted software development.

Prerequisites🔗

Agentty runs inside Git repositories and uses linked worktrees for session isolation. Install Git using the official Git downloads for your operating system, then verify the installation:

git --version

Install🔗

npm is recommended because it supports Agentty's automatic update flow. Other installation methods remain available when npm is not the right fit.

npm install -g agentty

npx (no install)🔗

npx agentty

Shell installer🔗

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/agentty-xyz/agentty/releases/latest/download/agentty-installer.sh | sh

Cargo🔗

cargo install agentty

Verify a GitHub Release🔗

Install the GitHub CLI, then download a GitHub release artifact. Each artifact has keyless Sigstore build provenance that identifies Agentty's release workflow:

gh attestation verify PATH_TO_ARTIFACT --repo agentty-xyz/agentty

Release immutability also protects the published tag and complete asset set. Verify a specific release and a downloaded asset with:

gh release verify vX.Y.Z --repo agentty-xyz/agentty
gh release verify-asset vX.Y.Z PATH_TO_ARTIFACT --repo agentty-xyz/agentty

Prepare an Agent Backend🔗

Agentty also requires at least one supported agent CLI on your PATH. Install and authenticate one backend before launching Agentty:

  • Codex (codex, recommended; supports subscription usage): install the Codex CLI, then run codex login.
  • Claude (claude): install Claude Code, then run claude auth login.
  • Antigravity (agy 1.1.0 or newer): install the Antigravity CLI, then run agy and follow its sign-in flow.
  • Gemini (gemini): install the Gemini CLI, then configure an API key or Vertex AI authentication.

See Agents & Models before choosing credentials. Provider subscription and OAuth rules differ, and not every interactive CLI sign-in is suitable for third-party invocation through Agentty.

Start a Session🔗

  1. Open a git repository in your terminal.
  2. Run agentty.
  3. Start a new session and let the agent work in its dedicated worktree branch.

The optional Issues tab also requires the GitHub CLI. Install gh and run gh auth login to show open GitHub issues assigned to you in the active project.

Review Changes🔗

Inside agentty, open the diff view (d) to inspect the generated git diff before you keep or discard edits.