jetpack-agent-cloud

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

Installation

``bash


Install globally

npm install -g jetpack-agent-cloud

Or use npx

npx jetpack-agent-cloud
`

Quick Start

`bash


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

`bash


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:

`bash


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
`

$3

`markdown


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

`typescript
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