gza-agent 0.4.0

A coding AI agent runner for Claude Code

GZA

AI agent task runner. Queue coding tasks, let AI agents work through them autonomously in parallel in isolated Docker containers, get git branches with completed work.

Why Gza

AI coding agents are powerful but interactive — you describe a task, watch the agent work, review, repeat. That's fine for one task, but not for twenty.

Gza turns agent coding into a batch workflow: queue tasks, run them in parallel on isolated branches, come back to completed work. Each task gets its own Docker container and git worktree. Failed tasks can be resumed. Reviews and improvements can be automated into loops.

Installation

pip install gza-agent

Or with uv:

uv tool install gza-agent

Requirements

• Docker - Tasks run in isolated containers (can be disabled)
• Claude Code - Default AI provider

Quick Example

# Initialize your project
gza init

# Queue some tasks
gza add "Add input validation to the registration form"
gza add "Refactor payment module to use the new API"
gza add "Add unit tests for the email service"

# Run them in parallel
gza work --background
gza work --background
gza work --background

# Check progress
gza ps

# Review and merge completed work
gza review 1
gza merge 1 --squash

Documentation

For full documentation, examples, and configuration options, see the GitHub repository.

• Quick Start Guide
• Configuration Reference
• Examples

License

MIT