Core concepts
Use this section when Coldtea's nouns start to matter: brew, pane, task, plan, session log, worktree, TeaHouse.
The product is easier to use when you know what each word owns. A task holds intent. A brew is an agent session. A pane is where work is visible. A worktree is a separate Git working directory, not a machine sandbox.
Start with the model
- Mental model — the short version of how the pieces fit together.
- Projects, brews, panes, and tabs — the workspace structure you look at all day.
- Agents — how Coldtea hosts CLI agents without hiding their terminal UI.
Understand the work record
- Tasks, plans, and logs — what to read before and after a brew.
- Context — how instructions, task details, and local project files shape an agent session.
Split work carefully
- Worktrees — run separate branches side by side without mixing edits.
- Run parallel agents — the workflow version of the same idea.
If you are new, read Mental model first. It gives you enough vocabulary to use the rest of the docs without guessing.