Agent Mode

Run coding agents in Msty Studio Desktop

Agent Mode lets you run coding agents inside Msty Studio Desktop. You can chat with an agent, review plans, inspect diffs, and approve actions in one workspace-aware flow.

Setup (Desktop)

Open Agent Mode settings

Go to Settings > Agent Mode.

Install and sign in to an agent

Install one supported CLI agent (Codex, Claude Code, or Gemini CLI), run it once in your terminal, then complete sign-in.

Refresh adapters

Back in Settings > Agent Mode, run Check updates to refresh available agents.

Install a CLI Agent

If you start a new Agent Mode session and no coding agent is detected, Msty shows an onboarding screen with install steps. The flow is the same for each supported CLI:

  1. Install the CLI with npm.
  2. Run the CLI once in your terminal.
  3. Complete the sign-in flow.
  4. Return to Msty and select Re-check for agents or Check updates in Settings.

If npm is not installed, install Node.js first. On Linux, you can also use the Node.js package manager instructions.

Codex
Gemini CLI
Claude Code

Codex

Codex is OpenAI's terminal coding agent and uses your ChatGPT account.

Install

npm install -g @openai/codex

Run Once

codex

When Codex opens, choose Sign in with ChatGPT. After sign-in, return to Msty and re-check for agents.

Codex documentation

Terminal Tips

The onboarding screen also includes basic terminal guidance:

  • macOS: Open Terminal with Command + Space, type Terminal, then press Return.
  • Windows: Open Windows Terminal or PowerShell from the Start menu.
  • Linux: Open your preferred Terminal app from the applications menu.

Major Parts

Sessions and workspaces

Start an Agent session from the New menu or from Easy Access. Sessions can target a workspace repository, or run folderless for quick tasks.

Plans and approvals

Agents can propose a plan before applying changes. Review each step and approve what should run.

Skills and slash commands

Use slash commands and installed skills to speed up repeated workflows. To create, manage, and install skills, see Skills Studio.

Diff and commit flow

Review generated file diffs, then commit from the workspace diff panel when you are ready.

Using Agent Mode

  1. Start a new Agent session.
  2. Describe the change and include context.
  3. Review the proposed plan and approve actions.
  4. Inspect diffs and iterate with follow-up prompts.
  5. Commit when complete.

Image placeholder: Agent session showing plan panel, approvals, and workspace diff

Notes

  • Agent Mode is currently available on Msty Studio Desktop.
  • If no agents appear, re-run your agent CLI setup in terminal and refresh adapters in settings.