Summary

Supacode provides a native macOS command center for running multiple coding agents in parallel. It addresses the complexity of managing concurrent agent tasks by assigning each a dedicated Git worktree and terminal, ensuring isolation and persistence. This offers developers a streamlined, robust environment for asynchronous coding workflows.

How It Works

The core is a "worktree-first" workflow where each task spawns a unique Git worktree and a persistent terminal session managed by the zmx daemon. This design prevents agent collisions and ensures sessions survive application restarts or dropped SSH connections. Remote repositories over SSH are supported, multiplexing connections for efficiency and leveraging zmx for remote session resilience.

Quick Start & Requirements

• Requirements: macOS 26.0+, mise for toolchain management, ~/.local/bin in PATH, Git submodules initialized. Crucially, macOS 26.4+ requires Xcode 26.3 due to Zig linker incompatibilities with the newer SDK.
• Install/Run: Clone recursively, mise install, make doctor (to verify prerequisites and get fix commands), then make run-app to build and launch.
• Notes: make doctor provides specific commands to resolve missing build prerequisites. Building GhosttyKit from Zig source is noted as slow.

Highlighted Details

• Worktree-first workflow with live Git status, PR state, and agent presence badges.
• zmx daemon ensures background session persistence, retaining scrollback.
• Remote SSH repositories (Beta) with single authentication and resilient sessions.
• libghostty provides a full-featured terminal with tabs, splits, and theme sync.
• Command palette for mouse-free navigation and action execution.
• GitHub integration for live PR tracking, checks, and merge readiness.
• CLI and deeplinks for external control and automation.
• Customizable scripts per repository or globally.
• Auto-updates via Sparkle framework.

Maintenance & Community

Contributions are personally reviewed, emphasizing focused pull requests linked to prior issues. No community channels like Discord or Slack are mentioned in the provided text.

Licensing & Compatibility

The license type is not explicitly stated in the provided README text; refer to the LICENSE file for details. No specific compatibility notes for commercial use or closed-source linking are present.

Limitations & Caveats

Remote SSH repository support is marked as Beta. A significant build-time limitation exists for macOS 26.4+, mandating the installation and use of Xcode 26.3 due to Zig linker issues with the native SDK.