Ag.Sh

🛠️ ag.sh

Command-line ADE tooling to run multiple Claude Code/AI agents in parallel - each in its own isolated git worktree.

Spawn, manage, and orchestrate AI-powered development across concurrent tasks without stepping on your own changes.

One command gives you everything: a git worktree, a branch, and a tmux window with the agent and shell running in the same window. Spawn as many as you need. Detach, come back tomorrow, and everything is still there.

• Isolated - Every task runs in its own branch and worktree. Agents can't collide or overwrite each other.
• Persistent - tmux keeps agents alive when you close your terminal. Worktrees survive reboots. ag resume rebuilds everything from disk. If a tmux session dies, ag attempts to resume conversations for claude and codex.
• Stateless - Git worktrees are the state. No databases, no config files, no daemon. If tmux disappears, your work is still intact.
• Combined API - One CLI tool - ag spawn, ag kill, ag open, ag rm, ag ls. Nothing more.

# Get started with...
ag spawn auth --prompt "Fix the JWT refresh token bug"
ag spawn billing onboarding

That's three agents, three isolated checkouts, three tmux windows. Switch between them, zoom in, detach, resume.

Requirements

• bash 4+ or zsh 5+
• git 2.15+ (worktree support)
• tmux 3.3a+ (pane title support)
• An agent CLI (Claude Code, or any command)

Installation

1. Download ag.sh to somewhere permanent:

curl -o ~/.ag.sh https://raw.githubusercontent.com/andrewhathaway/ag.sh/refs/heads/main/ag.sh

1. Source it in your shell config:

# ~/.bashrc or ~/.zshrc
source ~/.ag.sh

1. Restart your shell or `source ~/.bashrc`.

2. `cd` into any git repo and run `ag help`.

Commands

| Command | Description