Supacode is an open-source terminal orchestration workspace and agent harness developed by Supabit. Built on top of a native terminal layer embedding Ghostty, it offers a multi-pane environment tailored for running and monitoring autonomous coding agents alongside standard developer terminal workflows. In daily use, Supacode manages concurrent agent sessions and shell sessions within a kind-agnostic pane and tab layout. It handles PTY lifecycle management, geometry negotiation, and surface rendering natively. The environment includes session snapshotting and hibernation mechanisms, preserving live terminal grids, cell metrics, and font scaling when backgrounding or restoring agent sessions. What differentiates Supacode from standard terminal multiplexers or basic CLI runners is its architectural focus on agent workflows. By tightly coupling an embedded high-performance terminal renderer (Ghostty) with session freezing (`zmx` snapshotting) and structured repository-level skill definitions, it prevents terminal corruption and layout wrapping during complex, multi-agent operations. Supacode is licensed as an open-source project and is under active development on GitHub.
Embedded Ghostty terminal engine — Integrates Ghostty natively for high-performance terminal rendering, PTY surface control, and precise cell metrics. - Kind-agnostic pane and tab layout — Organizes agent tasks and interactive terminals across configurable tabs, splits, and view anchors. - Session hibernation and snapshot restoration — Freezes active terminal grids, columns, rows, and font metrics during session tear-down to enable accurate resume via snapshots. - Dedicated PTY resize policy — Enforces geometry checks to avoid corrupting grid dimensions when detaching, backgrounding, or waking surfaces. - Repository-level agent skills — Houses custom agent skill sets (such as Tuist project generators) within workspace configuration paths.
Use cases
Use Case: Multi-Task Agent Orchestration Developers can run multiple AI coding agent sessions across dedicated tabs and split panes while running builds and tests in parallel. The native terminal layout allows continuous monitoring of process outputs without switching external terminal windows.
Use Case: Long-Running Session Hibernation Developers executing complex agent workflows can freeze inactive sessions to free system resources. Supacode stores the backing geometry and session snapshot, restoring the terminal surface upon wake without breaking terminal formatting.
Use Case: Project Skill Standardization Teams can integrate customized workspace skills into the repository configuration, allowing AI agents operating within the harness to follow reproducible build and scaffolding steps.
Who it is for
Supacode is designed for software engineers and power users who require a native, multi-pane terminal workspace purpose-built for orchestrating AI coding agents. It is less suitable for developers who only need a single-process headless CLI runner without terminal layout or snapshotting management.
Install guide
Installation Supacode is distributed as an open-source application built with native tooling and Tuist. Clone and build the project from source: bash git clone https://github.com/supabitapp/supacode.git cd supacode tuist generate
First Run Open the generated project in Xcode to compile and launch the application, or execute the built app bundle directly. Configure your workspace settings and terminal preferences in the configuration files.
Example Session Once running, navigate your terminal panes to inspect repository skills and invoke your local agent workflows: bash # Inspect available agent skills in the workspace ls -la .agents/skills/
SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
Agent Runbook — Agent Runbook is an open-source contract-based multi-agent skill framework developed by KnoxOps. It acts as an orchestrator and compiler that…
Weaver — Weaver is an open-source agent harness and orchestration framework maintained by sean35mm on GitHub. Built on top of the Bun…
Context Bridge — Context Bridge is an open-source CLI agent harness and context orchestration utility developed by serdardb. It is built to facilitate…
Hivelore — Hivelore is an open-source agent harness and contextual memory orchestrator created by Doucs91. It provides persistent project memory, decision tracking,…
Agentic Engineering Framework — Agentic Engineering Framework is an open-source orchestration harness and governance layer developed by Dimitri Geelen. It is designed to constrain,…