Install Coldtea

Install Coldtea when you already have a repo and at least one coding agent you want to run from the desktop app.

Coldtea hosts local CLI agents. If the agent works in your normal terminal, Coldtea can usually launch it once the app can find the binary and the project path.

Before you install

You need:

• The Coldtea desktop app for your operating system.
• A local Git repository.
• At least one supported CLI coding agent, such as Claude Code, Codex CLI, Gemini CLI, or OpenCode.
• Provider credentials for the agent you plan to use.
• Team access if your organization uses shared tasks, Linear, GitHub, or Matcha QA.

You do not need to connect every integration on day one. Start with one repo and one agent. Add team surfaces after the local loop feels right.

Install the app

1. Download the desktop app from the distribution channel provided by Coldtea or your team.
2. Move the app into your Applications folder if your operating system asks for it.
3. Open Coldtea.
4. Sign in if you use a TeaHouse, shared tasks, or integrations.
5. Choose the TeaHouse or workspace you want to work in.

A TeaHouse is the team boundary in Coldtea. It is where tasks, members, and connected services are scoped. If you are evaluating Coldtea alone, you can still start with a local project before inviting anyone else.

Check your agents

Coldtea launches the agent CLIs installed on your machine. Before starting a real task, check the agent from your normal terminal:

claude --version
codex --version
gemini --version
opencode --version

You only need the commands for the agents you actually use. If a command is not found, install or update that agent first, then reopen Coldtea so discovery can run again.

Open a project

1. In Coldtea, add or select a local Git repository.
2. Let the workspace load.
3. Confirm you can see a terminal area and the project files.
4. Review any repo instructions, such as AGENTS.md, before asking an agent to edit code.

Coldtea remembers recent projects, so you can get back to the same repo without adding it again.

Keep the first run small

For the first brew, avoid a sweeping prompt. Ask the agent to inspect the repo, explain the main app structure, or make one safe change you can review quickly.

A good first prompt:

Inspect this repo and explain where the docs app lives. Do not edit files yet.

That proves the terminal, project path, and agent setup work before you hand over code changes.

If setup looks wrong

Check these first:

• The repo is a real Git checkout.
• The agent command works in your normal shell.
• The provider auth for that agent is already configured.
• Coldtea has permission to access the project folder.
• You are in the correct TeaHouse if you expect shared tasks or integrations.

Next: run your first brew.