A fast, customizable coding agent harness built in Rust.
Designed for multi-session workflows, multi-model orchestration, and a streamlined terminal UI.
- Blazing-fast TUI — a responsive terminal interface that stays out of the way while you work.
- Multi-model support — plug in different LLM providers and switch between them per task.
- Multi-session workflows — run several agent sessions in parallel, each with its own state.
- Swarm coordination — orchestrate multiple agents on a single goal, with shared context and tool access.
- Extensible tooling — 30+ built-in tools, plus MCP support for adding your own.
- Compaction & memory — long-running sessions stay coherent thanks to background compaction and a persistent memory layer.
- Cross-platform — Linux, macOS, and Windows binaries.
curl -fsSL https://raw.githubusercontent.com/bitan-del/gcode-harness/master/scripts/install.sh | bashiwr -useb https://raw.githubusercontent.com/bitan-del/gcode-harness/master/scripts/install.ps1 | iexRequires a recent Rust toolchain (stable):
git clone https://github.com/bitan-del/gcode-harness.git
cd gcode-harness
cargo build --release
./target/release/gcode --helpAfter installing, point Gcode at your project directory and start a session:
cd /path/to/your/project
gcodeOn first run you'll be prompted to configure a model provider. See OAUTH.md for provider authentication details.
Heads up — Google OAuth setup. The Gemini and Antigravity "Sign in with Google" flows require your own Google Cloud "Desktop app" OAuth client. Register one at the Google Cloud Console and export the credentials before signing in:
export GEMINI_CLIENT_ID="your-id.apps.googleusercontent.com" export GEMINI_CLIENT_SECRET="your-secret" export GCODE_ANTIGRAVITY_CLIENT_ID="your-id.apps.googleusercontent.com" export GCODE_ANTIGRAVITY_CLIENT_SECRET="your-secret"API-key based providers (OpenAI, OpenRouter, etc.) work without this step.
This is a Rust workspace. The top-level Cargo.toml lists every member crate. The most important ones live under crates/:
gcode-core— core agent runtime and orchestration.gcode-tui-*— terminal UI components (rendering, markdown, session picker, etc.).gcode-provider-*— model provider integrations (OpenAI, Gemini, OpenRouter, etc.).gcode-tool-*— tool registry and tool implementations.gcode-mobile-*— mobile companion app glue.gcode-storage,gcode-memory-types— persistence and memory.
Documentation lives in docs/, and contributor guidance is in CONTRIBUTING.md and AGENTS.md.
Anonymous usage telemetry is opt-in. See TELEMETRY.md for what is collected and how to disable it.
Release process and packaging notes are in RELEASING.md.
Released under the MIT License.