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.18 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.

Review Changes🔗

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