Garcon is an open-source AI agent orchestrator and harness developed by cfal. It is designed to manage coding agent lifecycles, execution environments, tool integration, and scheduled interactions across terminal and server workflows. Operating primarily through a command-line interface, Garcon orchestrates task execution by handling tool normalization, agent decision requests, nested task blockers, and permission boundaries. It supports execution adapters like OpenCode, coordinating native binary tools, scheduled prompt dispatches, and session token expansion. What sets Garcon apart is its focus on robust execution harness mechanics. It actively handles compaction, lifecycle boundaries, permission isolation, and scheduled automation with chat ID resolution, providing structured terminal output such as collapsible message views for developer inspection. Garcon is an open-source project hosted on GitHub under public development, aimed at developers seeking programmatic agent orchestration and reliable execution boundaries.
Agent Harness & Tool Normalization — Standardizes built-in and external terminal tools across coding agent sessions. - Scheduled Prompt Dispatching — Automates execution flows and prompt triggers with dynamic chat ID template variable resolution. - OpenCode & Subprocess Integration — Coordinates native binary runners, fork boundaries, and tool compatibility checks. - Lifecycle & Decision Handling — Manages question lifecycle boundaries, settled decisions, and nested task blockers. - Collapsible CLI Interface — Organizes execution logs, tool calls, and model outputs into clean, expandable terminal messages. - Granular Permission Boundaries — Preserves and narrows permission identities across child execution tasks.
Use cases
Use Case: Scheduled Task Execution and Automation Developers configure Garcon to trigger scheduled prompt pipelines across active development environments, resolving chat IDs and context variables automatically upon dispatch.
Use Case: Tool-Assisted Agent Orchestration Engineers run Garcon to wrap coding agent backends like OpenCode, ensuring tool compatibility, question prompt forwarding, and terminal command isolation during multi-step refactoring runs.
Use Case: Supervised Execution with Structured Logging Teams inspect and review complex agent actions using Garcon's collapsible terminal messages, quickly expanding sub-task blockers, tool decisions, and native execution boundaries without log spam.
Who it is for
Garcon is built for software engineers and systems developers building or managing AI coding agent pipelines who need fine-grained control over execution lifecycles, scheduled prompts, and permission boundaries. It is less suitable for users looking for a plug-and-play IDE chat plugin without terminal or orchestration requirements.
Install guide
Installation Clone the repository and build the project using standard Go/Node build tools based on repository structure: bash git clone https://github.com/cfal/garcon.git cd garcon
First Run Configure required environment variables and verify your agent harness setup: bash # Verify binary and view help options ./garcon --help
Example Session Run Garcon against an agent session or scheduled prompt configuration: bash # Start a supervised agent workflow garcon run --task "Refactor common utilities and run tests"
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,…