Reference

CLI Commands Reference

Complete reference for all Jetpack CLI commands.

Command Overview

CommandDescriptionExample
initInitialize database and projectjetpack init
startStart coordinator + agents + web UIjetpack start -a 5 --strategy best-fit
agentJoin swarm as a single agentjetpack agent --skills typescript,react
loadLoad a plan from markdown/JSONjetpack load plan.md --name 'Auth'
taskCreate a single taskjetpack task -t "Fix bug" -p high
tasksList all tasksjetpack tasks
agentsList registered agentsjetpack agents
statusShow swarm statusjetpack status
resetReset stuck agents and recover orphaned tasksjetpack reset
recoverRecover stuck tasks from stale agentsjetpack recover
check-reservationsCheck file reservation conflictsjetpack check-reservations
hookInstall/uninstall pre-commit Git hookjetpack hook install
webStart dashboard onlyjetpack web

jetpack init

Initialize Jetpack in a project directory.

jetpack init                    # Use defaults (current directory)
jetpack init -d /path/to/project  # Specify directory
jetpack init --turso-url <url> --turso-token <token>  # Use Turso cloud

Creates:

  • .jetpack/jetpack.db - SQLite database (local mode)
  • .tasks/ - Task graph and execution log
  • .memories/ - Vector-enabled memory database
  • .turso/ - Embedded replica and sync metadata (if using Turso)
  • Updates CLAUDE.md with usage instructions

jetpack start

Start the full Jetpack system.

jetpack start                              # Uses config defaults
jetpack start -a 5                         # 5 agents
jetpack start --strategy graph-prioritized # Use smart prioritization
jetpack start --tui                        # Terminal UI dashboard
jetpack start --no-browser                 # Don't auto-open browser

Launches:

  1. SwarmCoordinator - manages agent lifecycle and work distribution
  2. AI Agents - execute tasks via AgentHarness (default: 3)
  3. Web Dashboard - http://localhost:3000
  4. Health monitoring - heartbeat checks and stale agent recovery

jetpack task

Create a new task.

# Simple task
jetpack task --title "Fix login bug"

# Complex task
jetpack task \
  --title "Add dark mode support" \
  --description "Implement theme switching across the app" \
  --priority high \
  --skills react,frontend,typescript \
  --estimate 45

jetpack status

Get current system status.

jetpack status

# Output example:
# === Jetpack Status ===
#
# Agents:
#   agent-1: busy
#     Working on: bd-a1b2
#   agent-2: idle
#   agent-3: busy
#     Working on: bd-c3d4
#
# Tasks:
#   Total: 10
#   Pending: 3
#   In Progress: 2
#   Completed: 5
#   Failed: 0

jetpack load

Load a plan from a markdown or JSON file.

# Preview what will be created
jetpack load plan.md --dry-run

# Load with a name
jetpack load plan.md --name "Auth System"

# Load from JSON
jetpack load plan.json

Markdown headers map to hierarchy: # = epic, ## = task group, - = leaf task (claimable).

jetpack agent

Join the swarm as a single agent.

# Join with specific skills
jetpack agent --skills typescript,react

# Join with a custom name
jetpack agent --name my-agent --skills backend,database

jetpack recover

Recover stuck tasks from stale or crashed agents.

jetpack recover

# Finds agents with no heartbeat and resets their claimed tasks to pending