CLI reference

Terminal commands

Run midas --help for the same list in the terminal. Session slash commands live on the Slash commands page.

• midas [project]Start the terminal UI in the current project, or in the path you pass.
• midas run "..."Run one task and print the result. Add --format json for machine output.
• midas attach <url>Connect the terminal UI to a Midas server that is already running.
• midas pr <number>Check out a pull request with gh, then start Midas in that checkout.
• midas session listList recent sessions in this project.
• midas session delete <id>Delete a session.
• midas export [id]Write a session as JSON to stdout. --sanitize removes sensitive values.
• midas import <file>Import a session JSON file.
• midas statsShow local token and cost statistics. Filter with --days, --tools, --models, --project.
• midas syncPreview an import of instruction and skill files. Add apply to write it.
• midas agent createCreate a custom agent in the project or global config.
• midas agent listList the agents available to this project.
• midas skill listList skills published to the team registry.
• midas skill push <name>Publish a skill directory to the team registry. Use --dir for a custom path.
• midas skill pull <name>Install a skill from the registry. Add --global for every project.
• midas mcp listList configured MCP servers and their connection state.
• midas mcp add <name>Add a remote server with --url, or a local one with a command after --.
• midas mcp auth <name>Run the OAuth flow for a remote MCP server.
• midas mcp logout <name>Remove the stored credential for an MCP server.
• midas plugin <module>Install an npm plugin and add it to config. Add --global for every project.
• midas modelsList the models available through the gateway.
• midas providers loginSign in to a provider and store the credential.
• midas providers listList the credentials Midas has stored.
• midas providers logout [name]Remove a stored provider credential.
• midas workspace listList the personal and organization workspaces this login can bill.
• midas workspace use <slug>Send new requests to a different workspace.
• midas webStart the local server and open the web interface.
• midas serveStart the headless HTTP server for another client to attach to.
• midas acpRun an Agent Client Protocol server over stdio for an editor client.
• midas relay startConnect this machine to the dashboard for remote control.
• midas relay share <id>Expose one session to the dashboard instead of the whole machine.
• midas relay statusShow whether remote control is on, and what is exposed.
• midas debug pathsPrint where Midas keeps data, config, state, and cache.
• midas upgradeUpgrade to the latest version, or to a version you name.
• midas uninstallRemove Midas and its files. --keep-config and --keep-data preserve them.

Session flags

These apply to midas. midas run takes the same session, model, agent, and worktree flags, plus the output flags below.

• --continue, -cContinue the last session in the project.
• --session, -sOpen a session by id.
• --forkFork the session you are continuing, leaving the original intact.
• --worktreeCreate a git worktree and run there. An optional value names it.
• --agentStart with a particular agent.
• --model, -mPin a model in provider/model form. Leave it off and Midas picks the model for each task.
• --autoAuto-approve permissions that are not explicitly denied.
• --manualStart the terminal UI in manual mode and prompt for every permission.

Headless output flags

• --format jsonEmit structured JSON events instead of formatted text.
• --file, -fAttach a file to the message.
• --attach <url>Run against a Midas server instead of a local instance.
• --titleSet the session title.
• --worktreeRun the task in a fresh git worktree.
• --continue, -cContinue the last session.
• --variantSet the model variant, such as high or max. Leave it off to let Midas choose.
• --autoAuto-approve permissions that are not explicitly denied.

What has no command

Cloud sandboxes and the GitHub pull request review system start from the dashboard, not from the CLI. CLI commands for both are not available yet. Use /review for a local review of a diff, and Reviews for the GitHub system.