Beadwork coordinates AI agent workers to complete coding tasks with durable state, retries, and intelligent merging. Works with Claude, OpenAI, VS Code, Cursor, pytest, ruff, black, and your entire development stack. Built for developers who value control and reliability.
Works with
Everything you need to orchestrate complex coding workflows
Define complex workflows as Directed Acyclic Graphs with dependency resolution and concurrent execution.
All task state is persisted to SQLite. Resume interrupted runs seamlessly with full history.
Automatic retry logic with exponential backoff. Configure max retries per task for reliability.
Automatic branch creation per task, commits, and intelligent merging via the refinery step.
Safe mode by default with command allowlisting. Override with explicit unsafe flag when needed.
Integrate Claude and OpenAI for AI-powered task execution. Automatic code extraction and artifact generation.
Real-time monitoring with FastAPI dashboard. Track molecules, beads, and agent status in your browser.
AI-powered task breakdown and orchestration. Like Gas Town's Mayor - describe what you want, it creates the workflow.
TOML-based reusable workflows with variable substitution. Define once, execute many times with different parameters.
Works with pytest, ruff, black, mypy, ESLint, and all major testing and code quality tools. Integrates with GitHub Actions, GitLab CI, and popular CI/CD platforms.
AI-powered task orchestration. Describe what you want in natural language, and the coordinator creates your workflow automatically. Most intelligent local-first orchestrator built for developers.
Get Started# Create workflow from natural language
gt coordinator create \
--name "User Authentication" \
--desc "Add login and signup functionality" \
--backend claude
# Run the orchestrated workflow
gt molecule run molecule-abc123
# Monitor execution status
gt statusname: "User Authentication"
nodes:
- id: bead-plan
title: "Plan authentication"
agent: planner
- id: bead-code
title: "Implement code"
agent: coder
depends_on: [bead-plan]
- id: bead-test
title: "Write tests"
agent: tester
depends_on: [bead-code]Get started in minutes with a single command
uv pip install -e .gt initgt molecule new --from examples/simple_molecule.yamlgt molecule run <molecule_id>See how Beadwork orchestrates complex tasks
AI-powered task breakdown and orchestration
# Describe what you want
gt coordinator create \\
--name "Auth System" \\
--desc "Implement user authentication" \\
--backend claude
# Coordinator creates molecule automatically
gt coordinator orchestrate \\
--molecule molecule-abc123Reusable TOML-based workflows
# List available formulas
gt formula list
# Execute a formula
gt formula cook release \\
--var version=1.2.0Traditional YAML-based workflow
name: "Feature Development"
nodes:
- id: bead-plan
title: "Plan feature"
agent: planner
- id: bead-code
title: "Implement code"
agent: coder
depends_on: [bead-plan]Understand the building blocks of Beadwork
An atomic work item with status, inputs, outputs, and retry tracking. Each bead represents a single task executed by an agent.
A workflow DAG of beads with dependencies. Molecules orchestrate multiple beads in the correct order with concurrency control.
Workers that execute beads. Types include planner, coder, tester, reviewer, and refiner. Backends are pluggable (Mock, Shell, Claude, OpenAI).
The merge and refine step that combines successful bead branches into a final PR-ready branch with test validation.
AI-powered orchestrator that analyzes tasks, breaks them down into beads, and manages execution. Like Gas Town's Mayor.
TOML-defined reusable workflows with variables. Define processes once, execute with different parameters. Perfect for releases, deployments, etc.
Major features added to match Gas Town capabilities
Integrate Claude and OpenAI for AI-powered task execution. Automatic code extraction and artifact generation.
# Use Claude backend
gt coordinator create \\
--name "Feature" \\
--desc "Build feature" \\
--backend claude
# Or OpenAI
gt new "Task" --agent coder
# Set backend in bead inputsReal-time monitoring with FastAPI dashboard. Track molecules, beads, and agent status in your browser.
# Start dashboard
gt dashboard --port 8080
# Open http://localhost:8080
# View real-time statusAI-powered task breakdown and orchestration. Describe what you want, it creates the workflow automatically.
# Create from description
gt coordinator create \\
--name "Auth System" \\
--desc "User login and signup"
# Orchestrate execution
gt coordinator orchestrate \\
--molecule <id>TOML-based reusable workflows with variable substitution. Perfect for releases, deployments, and repeatable processes.
# List formulas
gt formula list
# Execute with variables
gt formula cook release \\
--var version=1.2.0Per-agent configuration management. Set API keys, default agents, and runtime settings.
# Configure agent
gt config agent set claude \\
--key api_key \\
--value your-key
# Set default
gt config default-agent claudeUse Beadwork with your favorite tools
Programmatic access to all features
curl http://localhost:8080/api/moleculesFull CLI with shell completions
gt completion bashWorks seamlessly with your existing development stack