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.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gza_agent-0.5.0.tar.gz.
File metadata
- Download URL: gza_agent-0.5.0.tar.gz
- Upload date:
- Size: 2.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8d9b38133cf079aeeef70eea88f5e01256812c9f20c7050317a42410c72cb8a1
|
|
| MD5 |
8ca0c9de400391219c09fd3683c358d9
|
|
| BLAKE2b-256 |
be84ed5e8516452245a1557f517663f68d429b1779a4182fb20f4564f6eb126d
|
Provenance
The following attestation bundles were made for gza_agent-0.5.0.tar.gz:
Publisher:
pypi.yml on mhawthorne/gza
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gza_agent-0.5.0.tar.gz -
Subject digest:
8d9b38133cf079aeeef70eea88f5e01256812c9f20c7050317a42410c72cb8a1 - Sigstore transparency entry: 2456760844
- Sigstore integration time:
-
Permalink:
mhawthorne/gza@5ce8c283fd5cd472fe89ad3c9485fd81eb83d86c -
Branch / Tag:
refs/tags/v0.5.0 - Owner: https://github.com/mhawthorne
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi.yml@5ce8c283fd5cd472fe89ad3c9485fd81eb83d86c -
Trigger Event:
release
-
Statement type:
File details
Details for the file gza_agent-0.5.0-py3-none-any.whl.
File metadata
- Download URL: gza_agent-0.5.0-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8de618eee53692677b5a4aa6cd7e77c8db90849856d80944f3eb60cbe68d4254
|
|
| MD5 |
2f8ed6bf887a97ef6fe5fc53b93ac935
|
|
| BLAKE2b-256 |
707874b815c7f104281a851226fddb8a5033e184e6d503a3ea6b0a37929ebbf4
|
Provenance
The following attestation bundles were made for gza_agent-0.5.0-py3-none-any.whl:
Publisher:
pypi.yml on mhawthorne/gza
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gza_agent-0.5.0-py3-none-any.whl -
Subject digest:
8de618eee53692677b5a4aa6cd7e77c8db90849856d80944f3eb60cbe68d4254 - Sigstore transparency entry: 2456760938
- Sigstore integration time:
-
Permalink:
mhawthorne/gza@5ce8c283fd5cd472fe89ad3c9485fd81eb83d86c -
Branch / Tag:
refs/tags/v0.5.0 - Owner: https://github.com/mhawthorne
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi.yml@5ce8c283fd5cd472fe89ad3c9485fd81eb83d86c -
Trigger Event:
release
-
Statement type:
