Documentation Index
Fetch the complete documentation index at: https://mintlify.com/swe-agent/mini-swe-agent/llms.txt
Use this file to discover all available pages before exploring further.
mini is a REPL-style interactive command-line interface for running mini-swe-agent directly in your local environment. It is designed for interactive, exploratory use — you can guide the agent, confirm or reject its actions, take the wheel yourself, and steer it toward a solution without leaving the terminal.
When you run mini, you are prompted for a task (or pass one with -t). The agent then proposes actions in a loop, and depending on the mode you choose, those actions are either executed immediately, held for your approval, or typed by you directly.
CLI flags
| Flag | Description |
|---|---|
-t, --task | The task or problem statement to give the agent. If omitted, you will be prompted interactively. |
-c, --config | Path, filename, or key-value pair for the config to use. Defaults to mini.yaml or the path set in MSWEA_MINI_CONFIG_PATH. Multiple -c flags are merged recursively. |
-m, --model | Model name to use (e.g., anthropic/claude-sonnet-4-5-20250929). Overrides MSWEA_MODEL_NAME. |
-y, --yolo | Start in yolo mode — the agent executes actions without asking for confirmation. |
-o, --output | Path for the output trajectory file. Defaults to last_mini_run.traj.json in the global config directory. |
-l, --cost-limit | Per-run cost limit in dollars. Set to 0 to disable. |
--environment-class | Environment backend to use (e.g., local, docker). See Execution environments. |
--model-class | Model class to use (e.g., litellm, openrouter, or a full import path). Advanced. |
--agent-class | Agent class to use (e.g., interactive, or a full import path). Advanced. |
--exit-immediately | Exit without prompting when the agent wants to finish. Advanced. |
-h, --help | Show help and exit. |
When you pass
-c, the default mini.yaml config is not automatically included. If you want to layer overrides on top of the default config, pass it explicitly: -c mini.yaml -c model.model_kwargs.temperature=0.5.Modes of operation
mini supports three modes that control who executes commands. You can switch between them at any prompt with a slash command.
- confirm (default)
- yolo
- human
In
confirm mode, the agent proposes an action and waits for you to approve or reject it before anything runs.When the agent proposes an action, you will see a prompt like:- Press Enter to execute the action.
- Type a message and press Enter to reject the action and send your comment back to the agent.
- Type
/yto confirm and switch to yolo mode in one step. - Type
/uto skip execution and switch to human mode.
mini. It gives you full oversight of every command before it runs.Switching modes mid-session
You can switch modes at any point when the agent is waiting for input. The following slash commands are available at every prompt:| Command | Action |
|---|---|
/y | Switch to yolo mode |
/c | Switch to confirm mode |
/u | Switch to human mode |
/m | Enter a multiline comment |
/h | Show available commands and current mode |
Interrupting the agent
Press Ctrl+C at any time to interrupt the agent mid-step. After interrupting, you will be prompted to type a comment or a slash command. You can:- Type a message to send feedback to the agent and resume.
- Type
/y,/c, or/uto switch modes and continue. - Press Enter with no input to resume without sending a message.
Trajectory output
mini saves the full history of each run — all messages, costs, and the final exit status — to a trajectory file. By default this is saved to last_mini_run.traj.json inside your global config directory. The path to this directory is printed when you start mini.
To save the trajectory to a custom location, use the -o/--output flag: