Getting Started With Coldtea

What You Need

• The Coldtea desktop app.
• A Git repository you want to work on.
• At least one supported CLI coding agent installed on your machine, such as Claude Code, Codex CLI, Gemini CLI, or OpenCode.
• Access to any team workspace or integration your organization wants to use.

Coldtea hosts agents through your local shell. If an agent works in your normal terminal, Coldtea can usually launch it once the app can discover the agent.

Install And Open Coldtea

1. Install the desktop app from the distribution channel provided by Coldtea or your organization.
2. Open Coldtea.
3. Sign in if your workspace uses team features, shared tasks, or integrations.
4. Choose the organization or workspace you want to use.

For local-only evaluation, you can start with a single project before inviting teammates or connecting integrations.

Open A Project

1. Add or select a local Git repository.
2. Let Coldtea load the workspace.
3. Confirm the terminal and editor areas are available.
4. Review any project instructions the repository already provides for agents.

Coldtea stores local workspace preferences so you can return to recent projects.

Launch Your First Agent Session

1. Open a project workspace.
2. Choose an installed agent from the terminal empty state, shortcut, or launch controls.
3. Start with a small prompt, such as asking the agent to inspect the repository and summarize the main app structure.
4. Review the output in the terminal.
5. Use the editor and task views to inspect files, plans, or session artifacts created during the work.

Coldtea does not reinterpret the agent's own UI. Slash commands, prompts, permission requests, and terminal output belong to the agent you launched.

Work With A Team

If your organization uses shared tasks or integrations:

1. Accept the invitation from your team.
2. Confirm you are in the right organization.
3. Open or create a task with enough context for the work.
4. Launch the agent from that task when you want the session connected to the team's review record.

Next Steps

• Learn the terminal model in Working with CLI agents.
• Learn task workflows in Tasks, plans, and review flow.
• Learn the editor surface in Editor and workspace navigation.