> ## Documentation Index
> Fetch the complete documentation index at: https://termmate.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Using agents in TermMate

> Set the working directory, add project roots, review tool calls and file diffs, and enable Plan Mode for safe agent execution in TermMate.

TermMate provides a consistent interface for all agents. Here are the core concepts and features you'll use every day.

## Setting the WorkingDir (CWD)

By default, the agent starts in your current workspace directory.

* **VS Code**: Uses the primary folder of your active workspace.
* **Sublime Text**: Uses the root directory of your project file.

## Multi-Project Support

You can grant the agent access to additional directories beyond your primary workspace. This is useful for monorepos or projects with external dependencies.
This is similar to  **"Add Directory"** option in your agent CLI.

## Permissions & Tool Calls

Agents are "agentic" because they use tools. Before an agent can perform a destructive action, TermMate will ask for your permission:

* **File Edits**: Review a diff of the changes before they are applied.
* **Terminal Commands**: See the exact command the agent wants to run.

## Plan Mode

For complex tasks, we recommend enabling **Plan Mode**. In this mode:

1. The agent first analyzes the task and writes a detailed plan.
2. You review and approve the plan.
3. The agent executes the steps one by one.

This prevents the agent from going "off the rails" on large refactors.