Workgraph

A Git-native work graph for humans and agents. Durable tasks, decisions, and cross-repo agent handoff — as plain Markdown + JSON in a Git repo, no daemon.

Workgraph is not where agents think. It is where humans and agents agree on durable work state.

Getting started

Paste this to your coding agent:

Hey Claude, let's start using https://moul.github.io/workgraph/llms.txt

It installs the CLI, creates your private git-backed control repo, and starts using it. Prefer to drive it yourself? The docs below cover every path.

Docs

• How it works — the model in five minutes (start here).
• Getting started — run your own private instance, step by step.
• Usage — CLI / HTTP API / MCP, copy-paste for humans and agents.
• Web interface — the read-only dashboard (workgraph ui --serve).
• Spec — the file format and protocol.
• HTTP API · MCP — the gateway surfaces in detail.
• Agents: llms.txt — the entry point.
• AGENTS.md / CLAUDE.md — the operating contract workgraph init scaffolds into every control repo.

Jump straight to the common tasks:

• Install · Run with Docker, no Go
• Create your private control repo
• Serve for cloud & mobile agents
• Adopt an existing project

License

Apache-2.0 OR MIT (see LICENSE).