Support

Troubleshooting

Common issues and their solutions.

Build Issues

# Clean rebuild
pnpm clean && pnpm install && pnpm build

# Build specific package
pnpm --filter @jetpack-agent/coordinator build

Web UI Shows Wrong/Old Data

  1. Check JETPACK_WORK_DIR points to correct project
  2. Restart the web server after changing the env var
  3. Verify .beads/, .cass/, .jetpack/ exist in target directory

MCP Server Not Connecting

  1. Ensure it's built: pnpm build
  2. Check path in .claude/settings.local.json
  3. Restart Claude Code after config changes
  4. Run /mcp in Claude Code to verify

Plans Not Appearing in UI

  1. Check .jetpack/plans/ directory exists
  2. Verify JSON has all required fields: id, title, status, items
  3. Each item needs: id, title, status, priority, skills, dependencies

Agents Not Claiming Tasks

  1. Check agent skills match task requiredSkills
  2. Verify task status is ready (dependencies satisfied)
  3. Check messages in the DataLayer or web dashboard

No Tasks Showing

  1. Ensure Jetpack backend is running (jetpack start)
  2. Check .jetpack/jetpack.db exists in target project
  3. Verify API is accessible at /api/tasks
  4. If using standalone mode, ensure JETPACK_WORK_DIR is set correctly

Common CLI Errors

"Claude CLI not found"

npm install -g @anthropic-ai/claude-code

"ANTHROPIC_API_KEY not set"

export ANTHROPIC_API_KEY=your_key_here
# Add to ~/.bashrc or ~/.zshrc for persistence

"Port 3000 already in use"

jetpack start -p 3005  # Use different port
# Or kill existing process:
lsof -i :3000 | awk 'NR>1 {print $2}' | xargs kill