fabro/README.md

The open source software factory for expert engineers

AI coding agents are powerful but unpredictable. You either babysit every step or review a 50-file diff you don't trust. Arc gives you a middle path: define the process as a graph, let agents execute it, and intervene only where it matters. Why Arc?

---

Key Features

	Feature	Description
🔀	Deterministic workflow graphs	Define pipelines in Graphviz DOT with branching, loops, parallelism, and human gates. Diffable, reviewable, version-controlled
🙋	Human-in-the-loop	Approval gates pause for human decisions. Steer running agents mid-turn. Interview steps collect structured input
🎨	Multi-model routing	CSS-like stylesheets route each node to the right model and provider, with automatic fallback chains
☁️	Cloud sandboxes	Run agents in isolated Daytona cloud VMs with snapshot-based setup, network controls, and automatic cleanup
🔌	SSH access and preview links	Shell into running sandboxes with arc ssh and expose ports with arc preview for live debugging
🌲	Git checkpointing	Every stage commits code changes and execution metadata to Git branches. Resume, revert, or trace any change
📊	Automatic retros	Each run generates a retrospective with cost, duration, files touched, and an LLM-written narrative
⚡	Comprehensive API	REST API with SSE event streaming and a React web UI. Run workflows programmatically or as a service
🦀	Single binary, no runtime	One compiled Rust executable with zero dependencies. No Python, no Node, no Docker required
⚖️	Open source (MIT)	Full source code, no vendor lock-in. Self-host, fork, or extend to fit your workflow

---

Example Workflow

A plan-approve-implement workflow where a human reviews the plan before the agent writes code:

digraph PlanImplement {
    graph [
        goal="Plan, approve, implement, and simplify a change"
        model_stylesheet="
            *        { llm_model: claude-haiku-4-5; reasoning_effort: low; }
            .coding  { llm_model: claude-sonnet-4-5; reasoning_effort: high; }
        "
    ]

    start [shape=Mdiamond, label="Start"]
    exit  [shape=Msquare, label="Exit"]

    plan      [label="Plan", prompt="Analyze the goal and codebase. Write a step-by-step plan.", reasoning_effort="high"]
    approve   [shape=hexagon, label="Approve Plan"]
    implement [label="Implement", class="coding", prompt="Read plan.md and implement every step."]
    simplify  [label="Simplify", class="coding", prompt="Review the changes for clarity and correctness."]

    start -> plan -> approve
    approve -> implement [label="[A] Approve"]
    approve -> plan      [label="[R] Revise"]
    implement -> simplify -> exit
}

Agents run as multi-turn LLM sessions with tool access. Human gates (hexagon) pause for approval. The stylesheet routes planning to a cheap model and coding to a frontier model. See the DOT language reference for the full syntax.

---

📖 Documentation

Arc ships with comprehensive documentation covering every feature in depth:

• Getting Started -- Installation, first workflow, and why Arc exists
• Defining Workflows -- Node types, transitions, variables, stylesheets, and human gates
• Executing Workflows -- Run configuration, sandboxes, checkpoints, retros, and failure handling
• Agents -- Tools, prompts, skills, MCP integration, subagents, and permissions
• Tutorials -- Step-by-step guides from hello world to parallel multi-model ensembles
• API Reference -- Full OpenAPI spec with authentication, SSE events, and client SDKs
• CLI Reference -- Every command and flag documented

---

Quick Start

Install

Download the latest release for your platform:

# macOS (Apple Silicon)
curl -fsSL https://github.com/brynary/arc/releases/latest/download/arc-aarch64-apple-darwin.tar.gz | tar xz
sudo mv arc /usr/local/bin/

# Linux (x86_64)
curl -fsSL https://github.com/brynary/arc/releases/latest/download/arc-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv arc /usr/local/bin/

Or download directly from GitHub Releases.

Build from source

Requires Rust (latest stable):

git clone https://github.com/brynary/arc.git
cd arc
cargo build --release
# Binary is at ./target/release/arc

Run the setup wizard

arc install

Initialize your project

cd my-repo/
arc init

Run your first workflow

arc run hello

---

Help or Feedback

• Bug reports via GitHub Issues
• Feature requests via GitHub Issues
• Email bryan@qlty.sh for questions

---

Contributing

See CONTRIBUTING.md for build instructions and development workflow.

---

License

Arc is licensed under the MIT License.