Getting Started

Quick Start

Get up and running with Jetpack in 5 minutes.

1Prerequisites

# Check Node.js version (needs >= 20.0.0)
node --version

# Check pnpm (needs >= 9.0.0)
pnpm --version

# Install Claude Code CLI
npm install -g @anthropic-ai/claude-code

# Set API key
export ANTHROPIC_API_KEY=your_key_here

2Install Jetpack

# Clone and build
git clone https://github.com/agent-jetpack/jetpack-cloud.git
cd jetpack-cloud
pnpm install
pnpm build

3Initialize Your Project

cd /path/to/your/project
jetpack init

This creates the following structure:

your-project/
├── .jetpack/
│   ├── jetpack.db       # SQLite database (local mode)
│   ├── plans/         # Plan storage
│   └── mail/          # Agent message logs
├── .beads/
│   ├── graph.json     # Task dependency graph
│   └── execution_log.jsonl  # Append-only task log
├── .cass/
│   └── memory.db      # Vector-enabled memory database
├── .turso/            # Cloud database (if using Turso)
│   ├── local.db       # Embedded replica
│   └── .sync          # Sync metadata
└── CLAUDE.md          # Updated with Jetpack instructions

4Start Jetpack

jetpack start -a 3

Browser opens to http://localhost:3000 with the dashboard. The -a 3 flag spawns 3 agents.

5Create Your First Task

Option A: Load a markdown plan

cat > plan.md << 'EOF'
# Build Hello World API
## Create endpoint
- Add GET /hello endpoint that returns "Hello, World!"
- Add unit tests for the endpoint
EOF

jetpack load plan.md --name "Hello World API"

Option B: Use the CLI

jetpack task -t "Add hello world endpoint" -p medium -s typescript,backend

Option C: Use the Web UI

Click "New Task" in the dashboard Kanban board.