Home

Welcome to the GraphAgent wiki.

GraphAgent is a fork of opencode that adds a DAG workflow engine: the agent decomposes a task into a dependency graph of child-agent sessions and drives it to completion. State is durable, crashes are recoverable, and you can watch and control the whole graph from the terminal.

If you were not here when this project was built, read in this order:

1. Quickstart — from install to your first running graph in about five minutes.
2. Why GraphAgent — what the graph buys you, and when to keep using a single loop.
3. Differences from opencode — what the fork adds, and how to choose.
4. Concepts — nodes, waves, gates, revisions, ownership: the five words everything else uses.
5. Harness — the whole machinery in lifecycle order: entry, authoring boundary, scheduler, event sourcing, parent-child contracts, gates, revisions, budgets and recovery.
6. Authoring Workflows — writing and saving your own graph specs.
7. Real Examples — worked examples with transcripts of actual runs.
8. Engine Internals — the implementation detail behind each layer.
9. FAQ — model configuration, cost control, relation to upstream opencode.

中文区：首页-zh（九页完整镜像，从快速上手-zh开始）。

The README covers the same ground in condensed form; this wiki is where the walkthroughs live.