Skip to content
nicolegrosPublic

Latest commit

 

History

462 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

planeai

Documentation · Releases

A desktop app that lets you run multiple AI coding agents in parallel — each in its own persistent terminal session, orchestrated from a keyboard-first UI. Works with Kiro, Claude, Copilot, Codex, or any CLI-based agent.

Status: Early development. Expect breaking changes between releases.

Multi-agent support
Bring your agent (claude, codex, copilot, kiro, etc.)
Custom themes
Custom themes and presets
Terminal
Multi-tab terminal w/ WebGL rendering
Review diff
Review diff and send feedback to your agent

Features

  • Parallel agents — run as many AI coding sessions as you need, side by side
  • Persistent sessions — agents keep running when you quit the app (tmux backend, or the experimental daemon and rmux backends)
  • Provider-agnostic — works with Kiro, Claude, Copilot, Codex, or any CLI agent
  • Keyboard-first — command menu (Cmd+K / Ctrl+K), shortcuts for every action
  • Task management — built-in task tracker with lifecycle hooks and auto-dispatch
  • Jira connection — bundled Jira plugin with PKCE OAuth, plugin-scoped source settings, immediate periodic source sync, a dedicated sidebar section, departed-issue review prompts, and assignment to PlaneAI projects; Jira writeback is supported for configured lifecycle actions.
  • Git worktree isolation — parallel agents work on separate branches without conflicts
  • Cross-platform — macOS, Linux, and Windows

Install

macOS (Homebrew)

brew install --cask nicolegros/tap/planeai

Already installed planeai from the .dmg? Let Homebrew take over the existing app instead:

brew install --cask --adopt nicolegros/tap/planeai

The cask also puts planeai-cli on your PATH. The app keeps updating itself, so brew upgrade is not needed. Homebrew only loads casks from taps you trust, so use the full name nicolegros/tap/planeai in other brew commands or run brew trust nicolegros/tap once. brew uninstall --zap --cask nicolegros/tap/planeai also moves planeai's settings, data and ~/.planeai worktrees to the Trash.

Direct download

Download the latest release for your platform:

Platform Format
macOS (Apple Silicon) .dmg
macOS (Intel) .dmg
Linux .deb / .AppImage
Windows .exe

Requirements

  • At least one AI agent CLI on PATH (e.g., kiro-cli, claude, codex, gh copilot)
  • tmux (optional, for persistent sessions via tmux backend — brew install tmux on macOS)
  • rmux (optional, for persistent sessions via the experimental rmux backend — see rmux.io)

Configuration

planeai is configured via ~/.config/planeai/config.json. See the full configuration docs for providers, file editor selection (embedded, terminal, or external), templates, lifecycle hooks, and auto-dispatch.

Themes are plain CSS files in ~/.config/planeai/themes/. See the theming guide for creating custom themes.

Development

pnpm install
make dev

See CONTRIBUTING.md for prerequisites, testing, and contribution guidelines.

Tech Stack

  • Tauri v2 — Rust backend, webview shell
  • Svelte 5 — reactive UI with runes
  • xterm.js — terminal rendering
  • Tailwind CSS — utility-first styling
  • SQLite — local persistence

License

AGPL-3.0

Releases

Contributors

Languages