Constellagent

A macOS desktop app for running multiple AI agents in parallel. Each agent gets its own terminal, editor, and git worktree, all in one window.

Features

• Run separate agent sessions side-by-side, each in its own workspace with an isolated git worktree
• Full terminal emulator (xterm.js + node-pty)
• Monaco code editor with syntax highlighting and diffs
• Git staging, committing, branching, and worktree management
• File tree navigation
• Cron-based automation scheduling
• Sleep/wake recovery for automations (coalesces missed runs while app stays open)
• Keyboard-driven - Quick Open, tab switching, shortcuts

Getting started

Requires macOS and Bun.

bun run setup
bun run dev

Build and package

bun run build     # Production build
bun run dist      # Package as signed macOS DMG

Test

bun run test      # Playwright e2e tests

Automation scheduling notes:

• If the laptop sleeps during a scheduled time while the app is still running, Constellagent runs one catch-up execution on wake.
• If the app is fully quit, missed runs are not backfilled on next launch.