Overview
Use Coldtea when an agent needs a real place to work: a terminal, the repo, a task, and a review trail you can inspect later.
Coldtea is a desktop workspace for AI coding agents. It does not replace Claude Code, Codex CLI, Gemini CLI, OpenCode, or any other agent with a new chat box. It launches those tools in normal terminal panes and wraps the work with project context, files, tasks, plans, logs, and review surfaces.
The point is simple: you should be able to see what the agent did before you trust it.
What Coldtea gives you
A Coldtea workspace brings four things together:
- A project — a local Git repository opened in the desktop app.
- Brews — agent sessions attached to a project, task, or worktree.
- Panes and tabs — visible terminal, editor, task, and review surfaces.
- A record — task context, implementation plans, session logs, and diffs.
That means you can start an agent, leave it room to work, and still come back to something reviewable. The terminal output is not hidden behind a summary. The files are still files. The branch is still a branch.
The usual loop
Most Coldtea work follows the same path:
- Open a Git repo as a project.
- Create or open a task with the work you want done.
- Start a brew with the agent you trust for that job.
- Watch the terminal when it matters.
- Read the plan, session log, and diff.
- Run the checks you would normally run.
- Merge, continue, or throw the branch away.
For quick experiments, you can skip the task and start from a terminal pane. For team work, start from a task so the plan and session log stay attached to the thing being reviewed.
What Coldtea does not do
Coldtea does not make an unsafe command safe. Local agents run through your shell with the permissions available to your user account. If an agent asks to delete files, install packages, or touch secrets, treat that the same way you would in any terminal.
Coldtea also does not hide the agent's own interface. Slash commands, permission prompts, model selection, and provider auth still belong to the CLI agent you launched.
Where to go next
- Install Coldtea if this is your first setup.
- Take the workspace tour if you want names for the main surfaces.
- Run your first brew when you have a small task ready.