Overview

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

• Context: how instructions, task details, and local project files shape an agent session.
• Comments and annotations: how you point an agent at a terminal line, a diff line, plan text, or a live browser page.

For the task, plan, and log model, read tasks, plans, and logs in the Tasks section.

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.