jetpack-agent-cloud

Multi-agent AI orchestration for software development. Coordinate multiple AI agents to work on your codebase simultaneously.

Installation

# Install globally
npm install -g jetpack-agent-cloud

# Or use npx
npx jetpack-agent-cloud <command>

Quick Start

# Navigate to your project
cd your-project

# Start Jetpack with 3 agents (auto-initializes everything)
jetpack start -a 3 --no-web

# Or load a plan first, then start
jetpack load ./plan.md --name "Feature Plan"
jetpack start -a 3 --no-web

The --no-web flag is recommended for standalone installs (the web dashboard requires the full monorepo).

Commands

| Command | Description | |---------|-------------| | jetpack start | Start the full orchestration system (coordinator + agents) | | jetpack start -a 5 | Start with 5 agents | | jetpack start --no-web | Start without web dashboard | | jetpack init | Initialize Jetpack in current directory | | jetpack status | Show swarm status | | jetpack task | Create a new task | | jetpack tasks | List all tasks | | jetpack agents | List registered agents | | jetpack agent | Start a single agent work loop | | jetpack load | Load a plan from file or stdin | | jetpack reset | Reset stuck agents and recover tasks |

Creating Tasks

# Quick task creation
jetpack task -t "Fix bug in auth module" -p high -s typescript

# With description
jetpack task -t "Add dark mode" -d "Implement dark mode toggle in settings" -p medium

# Multiple skills
jetpack task -t "Create API endpoint" -s backend,database,typescript

Loading Plans

Load hierarchical plans from markdown files:

# Load from markdown file
jetpack load ./my-plan.md --name "Feature Plan"

# Load from stdin
echo "Build user authentication" | jetpack load -

# Preview without creating (dry-run)
jetpack load ./plan.md --dry-run

# Load and activate immediately
jetpack load ./plan.md --activate

Markdown Plan Format

# Feature Name (becomes Epic)

Description of the feature.

## Task 1 (becomes Task)
- Subtask 1.1 (becomes Subtask)
- Subtask 1.2

## Task 2
- Subtask 2.1

Programmatic Usage

import {
  createLibSQLLocalDataLayer,
  createPlanLoader,
  SwarmCoordinator,
} from 'jetpack-agent-cloud';

// Create data layer (auto-initializes schema)
const dataLayer = await createLibSQLLocalDataLayer('.jetpack/jetpack.db');

// Create a task programmatically
const task = await dataLayer.tasks.create({
  title: 'Implement feature X',
  priority: 'high',
  requiredSkills: ['typescript'],
});

// Load a plan
const loader = createPlanLoader(dataLayer);
const result = await loader.load('./my-plan.md', {
  title: 'My Feature',
});

// Start coordinator
const coordinator = new SwarmCoordinator(dataLayer, {
  workDir: process.cwd(),
  maxAgents: 5,
});
await coordinator.start();

Environment Variables

| Variable | Description | |----------|-------------| | JETPACK_WORK_DIR | Override working directory | | ANTHROPIC_API_KEY | Required for Claude agents | | OPENAI_API_KEY | Required for OpenAI/Codex agents |

Requirements

• Node.js >= 18.0.0
• Claude CLI (claude) or OpenAI Codex CLI for agent execution

Links

• GitHub Repository
• Documentation
• Issues

License

MIT