Use local coding agents in the macOS app
Run Codex, Claude Code, Cursor, OpenCode, or Grok CLI on your Mac from a Mantle chat.
Written By Katja Danilina
Last updated About 1 month ago
The macOS app can use coding tools installed on your Mac, including Codex, Claude Code, Cursor, OpenCode, and Grok CLI. You sign in through each tool's official sign-in, and that provider's terms and usage limits apply. Local agents don't use Mantle credits.
Set up a local agent
Install the coding tool and sign in to it on your Mac, following its own instructions.
In the macOS app, go to Settings → Local providers.
Choose the provider. Mantle checks that the tool is installed and signed in, and shows what to do next if it isn't.
Turn the provider on. In the chat model picker, switch to Local models to see its models.
If an agent can't run yet, the model picker shows why with a button: Sign in, Install, or Settings. When a newer version is available, you'll see Update.
Choose the folder the agent works in
Below the message box, a local chat shows the folder the agent works in and its git branch. Click it to choose another folder or open the folder in Finder, your editor, or Terminal. Each chat keeps its own folder.
Choose what the agent may do
The access control next to + in the message box sets what the agent may do:
Read only: reads and answers, changes nothing.
Ask first (default): asks before changing files or running commands.
Edit automatically: edits files in the folder without asking; commands still ask.
Full access: runs anything without asking.
Turn on Plan mode in the + menu to get a plan before the agent changes anything (Claude Code, Codex, and OpenCode).
Follow, review, and undo changes
The reply shows the commands the agent ran, the files it changed, its to-do list, and its reasoning as it works. When the agent asks for permission, choose Approve, Always allow, Decline, or Stop.
A reply that changed files ends with a line like “3 files changed +12 −4”; click it to see the diff. Choose Undo these changes to take back only what that reply changed. Mantle reads changes with Git on your Mac and never uploads them; the folder must be a Git repository.
Below the message box you can also see how much of your Codex or Claude subscription's 5-hour and weekly limits is left.
Full guide: https://docs.mantle.chat/features/desktop-app
Was this helpful?
More in Account, Apps & Settings
Keyboard shortcutsAccessibilityExport, archive, and manage your dataYour profile, signing out, and deleting your accountStill need help? Ask the team