03 Core concepts and features
Switch local Agents
In local projects, you can use Mira or connected Agents such as Codex and Claude Code to work on code, data, and project files. Mira provides a common chat interface showing execution steps, file changes, and approval requests.
Install and connect an Agent
Open Agents from the user menu or Settings to view Agents detected on this computer. Filter by All, Available, or Unavailable and check installation, login, and version status.
- Find the Agent you want and click Install and connect.
- Where automatic installation is supported, click Install and connect. Alternatively, follow the Installation guide or select a program already installed on your computer.
- Sign in to the Agent provider as prompted. For terminal login, Mira copies the login command and opens a terminal. Return to Mira when finished.
- Click Check status and confirm that the Agent is available.
Mira-managed installations download and verify a specified version from official sources and store it in a dedicated directory. The page distinguishes Mira-managed, Automatically detected, and Manually selected program sources so you can identify the installation in use.
The Agents page may also list integrations such as OpenCode and OpenClaw. Complete detection or connection as instructed. Only connected Agents that support the current conversation appear in its selector.
Configure the model, reasoning level, and runtime permissions
Click Edit beside an Agent to adjust New conversation defaults and Runtime permissions, then click Save and test.
Setting | Purpose |
|---|---|
Model | Set a model for new conversations or use the Agent's default. Custom model names can be entered where supported. |
Reasoning level | Adjust reasoning effort using the Agent's available options. |
Runtime permissions | Use the Agent's native execution and approval modes for subsequent runs, including existing conversations. |
Program and login | View or select the executable and check installation and login status. |
Codex offers modes such as Read Only, Auto, and Full Access; Claude Code offers Plan, Default, and Accept Edits. Review available options and descriptions in the dropdown. Before granting broader permissions, read the confirmation page's explanation of file, command, and network access.
Choose an Agent for a new conversation
- Switch to a local project linked to a working directory and click New conversation.
- Click + (Add and settings) at the bottom left of the input and open Agent.
- Choose Mira or another connected Agent, check the model and reasoning level, and enter your task.
- The conversation's Agent is fixed after the first message. Start a new conversation to use a different Agent.
You can still change the model and reasoning level within a conversation; changes apply from the next message. Default models set for other Agents do not change Mira's own base-model selection.
Provide research materials and view outputs
Place data, code, and documents in the local project's working directory. Specify filenames, processing goals, and output locations in the task, or provide materials through a supported local-file entry point.
Local Agent conversations currently do not support Mira knowledge-base search or Wiki references. Save the required materials locally and provide them in the local project. If a cloud-file reference cannot be passed through, select the file again from your computer.
During execution, expand commands, tool calls, or file changes to inspect inputs, outputs, and status. When the Agent requests approval, check the command, paths, and reason, then choose an available option such as Allow once, Allow for this conversation, or Deny.
Save outputs in the project's working directory so they are easy to preview and reuse in Mira. Files written to the desktop or elsewhere outside the project must be viewed at those locations.