Autonomous task execution with Claude. Give it a goal, let it run until complete.
# Install as a CLI tool
pipx install fireteam
# or
uv tool install fireteamRequires Python 3.12+ and Claude Code CLI installed.
- Create a
PROMPT.mdfile in your project:
# Task
Fix the authentication bug where users can't log in after password reset.
## Context
@src/auth.py
@tests/test_auth.py- Run Fireteam:
# Start a background session (tmux)
fireteam start
# Or run in foreground
fireteam run- Monitor progress:
# List running sessions
fireteam list
# Attach to watch live
fireteam attach fireteam-myproject
# View logs
fireteam logs fireteam-myprojectFireteam estimates task complexity and routes to the appropriate execution strategy:
| Complexity | Mode | Behavior |
|---|---|---|
| TRIVIAL | SINGLE_TURN | Direct execution, single pass |
| SIMPLE | SINGLE_TURN | Direct execution, single pass |
| MODERATE | MODERATE | Execute → review loop until ≥95% complete |
| COMPLEX | FULL | Plan once, then execute → 3 parallel reviews until 2/3 say ≥95% |
It loops until the task is complete—no babysitting required.
Start a background session in tmux:
fireteam start # Use PROMPT.md in current directory
fireteam start -p /path/to/project # Specify project directory
fireteam start -f task.md # Use specific goal file
fireteam start -g "Fix the bug" # Pass goal as string
fireteam start -m full # Force execution mode
fireteam start --max-iterations 10 # Limit iterationsRun in foreground (blocking):
fireteam run # Use PROMPT.md in current directory
fireteam run -p /path/to/project # Specify project directoryList all running Fireteam sessions.
Attach to a running session to watch progress. Detach with Ctrl+B D.
View session logs:
fireteam logs fireteam-myproject # Last 50 lines
fireteam logs fireteam-myproject -n 200 # Last 200 linesTerminate a running session.
Fireteam auto-detects PROMPT.md (or fireteam.prompt.md, prompt.md) in your project directory. Use @ syntax to include files:
# Task
Refactor the authentication system to use JWT tokens.
## Current Implementation
@src/auth/
@src/middleware/auth.py
## Requirements
- Replace session-based auth with JWT
- Add refresh token support
- Update all tests
## Additional Context
@docs/auth-spec.mdInclude patterns:
@path/to/file.py- Single file@path/to/directory/- All files in directory@src/**/*.py- Glob pattern
Environment variables:
| Variable | Default | Description |
|---|---|---|
FIRETEAM_MAX_ITERATIONS |
unlimited | Max loop iterations |
FIRETEAM_LOG_LEVEL |
INFO | Logging verbosity |
Fireteam can also be used as a Python library:
from fireteam import execute
result = await execute(
project_dir="/path/to/project",
goal="Fix the authentication bug",
)
if result.success:
print(f"Completed in {result.iterations} iterations")See docs/ for full API documentation.
git clone https://github.com/darkresearch/fireteam
cd fireteam
uv sync --extra dev
uv run pytest tests/ -vMIT License