Coldtea docs

Use these docs when you want to run coding agents in Coldtea without losing sight of the work.

Coldtea hosts agent CLIs in visible terminal panes and keeps the surrounding context close: projects, brews, tasks, plans, session logs, diffs, and worktrees. The docs are organized around that loop.

Start here

• Overview — what Coldtea is, what it gives you, and what it does not hide.
• Install Coldtea — get the desktop app, open a repo, and check your local agents.
• Your first brew — start with one small, reviewable agent session.
• Workspace tour — name the main surfaces before you use them.

Learn the model

• Mental model — TeaHouse, project, tab, pane, and brew.
• Tasks, plans, and logs — how Coldtea keeps work reviewable.
• Worktrees — split branches without pretending they are security sandboxes.

Do the work

• Review agent work — inspect the task, plan, log, diff, and checks.
• Run parallel agents — use separate worktrees when work can be split safely.
• Use tasks — keep team work attached to the record it needs.

Set up the workspace

• Agent setup — connect the CLIs you already use.
• Provider credentials — understand where model auth lives.
• GitHub and Linear — connect team systems where your TeaHouse uses them.

Teams and reference

• Teams & security — roll out Coldtea with local permissions in mind.
• Reference — shortcuts, troubleshooting, config, glossary, and agent support details.