Guides
Branches
Fork, diff, and merge knowledge safely from the Console.
The Branches tab visualises your project's branch topology as a live git-graph (streamed over SSE) and lets you drive the full lifecycle. For the concept, see Branches.
Common tasks
| Task | How |
|---|---|
| See the branch DAG | The Branches tab renders lineage live. |
| Create a branch | POST /api/v1/branches (name + parent). |
| Inspect changes | GET /api/v1/branches/{branch}/diff — claims added/removed vs the parent. |
| Merge to main | POST /api/v1/branches/{branch}/merge — blocked if it would add contradictions or drop health. |
| Undo a merge | POST /api/v1/branches/{branch}/rollback. |
| Promote a branch | POST /api/v1/branches/{branch}/checkout to make it the new main. |
Session branches happen automatically
You usually don't create branches by hand. Every agent/MCP session gets its own
stream/{session_id} branch that auto-merges when the session ends — so
concurrent agents stay isolated and every session is a revertible unit. See
the concept.
Merges are guarded
A merge that would introduce a contradiction or degrade graph health is rejected, not silently applied. Check the diff first; roll back if a merge turned out wrong.