Ittybitty

ittybitty (ib)

A single bash script that lets you spawn, organize, and control multiple Claude Code agents.

Benefits:

- Staying safe: Tool use is pre-approved only, all others denied. Yolo mode is optional, *not required*.
- Simple command line interface to start, stop, monitor, merge, and kill agents. Simple for Claude to understand and use within your normal Claude sessions. Use Claude to spawn teams of Claude agents!
- View and control any agent, use $ ib watch to view and control all agents running in a repo
- Each agent gets its own git worktree (keep working in your normal git repo while agents fix bugs for you.)
- Agents can spawn helper agents and message each other
- Optional custom prompt for all new agents
- Automatic notifications to agents when their dependencies complete
- Agents can even resume after a system reboot and pick up where they left off
- Minimal dependencies, only requires claude, tmux, and git

How It Works

When you spawn an agent with ib, it:

1. Creates a git worktree on a new branch (agent/) - isolated from your main working tree (inside .ittybitty/agents//)
2. Starts a tmux session running Claude Code in that worktree
3. Monitors the agent's state (running, waiting, complete, stopped)

Agents are either managers or workers. Manager agents coordinate work and can spawn other managers and workers; worker agents execute focused tasks and cannot create new agents. When an agent completes, you review its changes and merge them back to your branch.

You don't need to change your workflow to use ittybitty. You can think of its agents as _just_ another Claude Code terminal that can work independently, stays within allowed tool permissions, and can spawn and message other agents. You can view, merge, or kill any agent at any…