Skip to content

Cub

Work ahead of your AI agents

Turn your ideas into structured tasks, then let AI execute autonomously while you focus on what matters.

curl -LsSf https://docs.cub.tools/install.sh | bash

Get Started View on GitHub

Get Running in Three Steps

1. Initialize

cub init --global
cd your-project && cub init

Set up your global config and project files.

2. Prep Your Tasks

cub prep

Transform your ideas into structured, agent-ready tasks through guided refinement.

3. Run the Loop

cub run

Let Cub execute tasks autonomously until complete or budget exhausted.

The Two Main Events

Prep: Vision to Tasks

Go from a rough idea to structured, agent-sized tasks:

  • Triage - Clarify requirements and goals
  • Architect - Design the technical approach
  • Plan - Break work into agent-sized chunks
  • Bootstrap - Write tasks to your backend
cub prep                 # Full pipeline
cub triage && cub plan   # Or run stages individually

Learn about Prep

Run: Tasks to Code

Execute tasks with the AI harness of your choice:

  • Autonomous loop - Picks and executes tasks
  • Multi-harness - Claude, Codex, Gemini, OpenCode
  • Smart routing - Right model for each task
  • Budget tracking - Stay within token limits
cub run                  # Run until complete
cub run --once           # Single iteration
cub run --stream         # Watch in real-time

Learn about Run

Why Cub?

Finding the Balance

AI coding agents in 2026 are powerful. They can operate for hours, produce working code, run tests, and iterate toward production quality. But there's a gap between too hands-on (approving every tool call) and too hands-off (hoping for the best with vague instructions).

Cub finds the middle ground. You invest time before code starts flying, then step back and let execution happen.

Right Model for the Task

Route simple tasks to fast models, complex work to capable ones. Manage tokens as a resource.

Multi-Harness Flexibility

Claude Code, OpenAI Codex, Google Gemini, OpenCode. Use the right tool without vendor lock-in.

Deterministic Control

Task selection, retry logic, and state transitions run as traditional software, not LLM inference.

Budget Management

Track tokens across tasks with configurable limits and warnings. No runaway spending.

Git Workflow Integration

Branch per epic, commit per task. Clean state enforcement keeps your repo healthy.

Hooks System

Custom scripts at lifecycle points. Slack notifications, metrics, alerts - whatever you need.

Documentation Sections

Getting Started

Installation, quick start guide, and core concepts to get you productive fast.

User Guide

In-depth coverage of configuration, task management, the run loop, and advanced features.

CLI Reference

Complete reference for all Cub commands with examples and options.

Troubleshooting

Common issues, error reference, and frequently asked questions.

Topic Description
Installation Get Cub installed on your system
Quick Start Start using Cub in 5 minutes
Configuration Customize Cub for your workflow
Task Backends Beads vs JSON task management
AI Harnesses Claude, Codex, Gemini, OpenCode
Hooks System Extend Cub with custom scripts
Contributing Help improve Cub