Core Concepts
The main objects in Agentree and how they fit together.
Workspace
A workspace is the durable container for an Agentree session. It stores the conversation graph, agent runs, branch state, and related project context.
Message Graph
Agentree stores conversations as a graph instead of a single linear chat. Messages can have descendants, alternate branches, summaries, and commit-linked nodes.
Branching
Branching creates a new path from an existing message. This is useful when you want to test an implementation direction, debug with a different hypothesis, or ask another agent to explore a separate path.
Worktrees
Agentree can pair agent branches with isolated worktrees. That keeps parallel experiments from colliding at the filesystem level.
Merging
When a branch produces the useful result, you can bring its code changes back into the main project flow while keeping the reasoning history intact.