---
slug: "pi-constell-plan"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/owengretzinger/constellagent@main/README.md"
repo: "https://github.com/owengretzinger/constellagent"
source_file: "README.md"
branch: "main"
---
# 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.

<img width="3506" height="2200" alt="image" src="https://github.com/user-attachments/assets/9f055656-c213-4d56-8af4-251bd739ad8b" />

## 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](https://bun.sh).

```bash
bun run setup
bun run dev
```

### Build and package

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

### Test

```bash
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.