Skip to content

liu1700/racc

Repository files navigation

Racc

Racc

A desktop control plane for orchestrating AI coding agents.

License Release


Racc Demo

What is Racc?

Racc is a desktop app that lets you run multiple AI coding agents in parallel — each in its own terminal, its own git worktree, fully isolated. It's not a code editor. It's the control plane you've been missing.

Currently supports Claude Code, with Codex support planned.

Features

  • Multi-agent sessions — Run multiple agent sessions side by side
  • Agent-agnostic — Communicates via native PTY, works with any agent that runs in a terminal
  • Git worktree isolation — Each session gets its own worktree automatically, no conflicts
  • Task board — Kanban-style board for cognitive offloading and automated agent orchestration
  • Remote servers — SSH into remote machines and run agents in persistent tmux sessions
  • Server management — Add servers via SSH config import or manual setup, with connection testing and status tracking
  • Headless server — Run racc-server for browser-based access from any device on your Tailscale network

Roadmap

Milestone Description Status
v0.1 — MVP Multi-session dashboard, task board, git worktree isolation, file viewer Done
v0.2 — Remote & Multi-Agent Remote server sessions via SSH/tmux, Codex support, Docker sandbox In progress
v0.3 TBD

Download

Grab the latest .dmg from the Releases page.

Build from Source

Prerequisites: Rust (stable) | Bun (v1.0+) | Git | Tauri 2.x prerequisites

Note: If you don't have Rust installed, run:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
git clone https://github.com/liu1700/racc.git
cd racc
bun install

# Desktop app
bun tauri dev

# Headless server (browser access)
bun run build
cd src-tauri && cargo run --bin racc-server
# Open http://localhost:9399 or http://<tailscale-host>:9399

Architecture

Three-crate Rust workspace: racc-core (business logic), racc-server (headless axum binary), and the Tauri desktop app (thin wrappers). The React frontend auto-detects its environment — Tauri IPC in the desktop app, WebSocket in the browser. Sessions use native PTY locally or SSH/tmux for remote servers.

See the wiki for detailed design docs, including Technical Architecture and Cognitive Design Research.

Why "Racc"?

Short for raccoon — clever, adorable, with nimble little hands. But be careful — they can be surprisingly brutal sometimes.

Raccoon

Contributing

We welcome contributions! See CONTRIBUTING.md for setup instructions and guidelines.

License

MIT

About

A desktop app that lets you run multiple AI coding agents in parallel

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages