Introduction

Coldtea is a desktop app that runs coding agents across the whole software lifecycle. It hosts agent CLIs (Claude Code, Codex, Gemini, OpenCode) in visible terminal panes and keeps the surrounding work close, so building, reviewing, testing, and monitoring happen in one place.

Coldtea does not replace those CLIs with a new chat box. It launches the tools you already use and wraps the work with project context, files, tasks, plans, logs, and review surfaces. The point is that you can see what the agent did before you trust it.

What it gives you

• Agents you direct in visible terminal panes, with tasks, plans, and session logs kept next to the work.
• Review that stays close to the code: diffs, comments, and checks before anything ships.
• Testing with Matcha, our testing agent: web and mobile QA, run against a URL or a build.
• Team workflows: a shared board, workflow states, and GitHub and Linear connections.
• Self-driving monitoring that runs QA and maintenance on a schedule.

What it does not hide

You keep the ability to see and check what the agents did. Coldtea shows the terminal, the diff, the plan, and the run evidence, instead of asking you to trust output you cannot inspect.

Local agents run through your shell with the permissions of your user account. Coldtea does not make an unsafe command safe. If an agent asks to delete files, install packages, or touch secrets, treat that the way you would in any terminal. Slash commands, permission prompts, model selection, and provider auth still belong to the CLI agent you launched.

What you need first

• The Coldtea desktop app.
• A local Git repository.
• At least one supported agent CLI installed on your machine.
• Provider auth for that agent.
• A TeaHouse, your team workspace in Coldtea. Setup requires one; you create or join it during first-run setup.

Do not wire every integration before the first run. Prove the local loop first: open the repo, start a session, review the result.

Where to go next

• Install Coldtea if this is your first setup.
• First-run setup to connect your account, a TeaHouse, GitHub, and a project.
• Your first brew when you have a small task ready.
• Terminal for the main surfaces.