> ## Documentation Index > Fetch the complete documentation index at: https://cli.devin.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Commands & Flags > Complete reference for command arguments, subcommands, and interactive slash commands ## Usage ```bash theme={null} devin [OPTIONS] [prompt] ``` Pass an optional prompt to start a session with an initial message, or launch interactively with no arguments. You can also read these from your terminal with `man devin`. *** ## Global Flags | Flag | Short | Description | | - | - | - | | `--model ` | | Set the AI model for this session | | `--permission-mode ` | | Permission mode (`normal`, `dangerous`, `bypass`) | | `--continue` | `-c` | Resume the most recent session in the current directory | | `--resume ` | `-r` | Resume a specific session by ID | | `--print [PROMPT]` | `-p` | Print response and exit (non-interactive mode). Optionally accepts an inline prompt. | | `--prompt-file ` | | Load the initial prompt from a file | | `--config ` | | Configuration file path | | `--export [PATH]` | | Export conversation to a file after each turn (ATIF format). Uses a default path if none is provided. | | `--respect-workspace-trust` | | Whether to respect workspace trust settings | **Examples:** ```bash theme={null} devin -- add a login page devin --model opus -- refactor the auth module devin -c # Resume last session devin -r abc12345 # Resume specific session devin -p "list all TODO comments" # Print response and exit devin -p -- list all TODO comments # Same, using -- separator (still works) devin --export -- fix the tests # Export conversation to default path devin --export out.json -- fix tests # Export to a specific file ``` *** ## Subcommands ### devin auth Authentication related commands. | Command | Description | | - | - | | `devin auth login` | Log in to your account | | `devin auth logout` | Log out and remove stored credentials | | `devin auth status` | Check authentication status | **Options for `devin auth login`:** * `--force-manual-token-flow` — Skip browser-based auth and manually paste a token (useful for remote/SSH sessions) ### devin mcp Connect and log in to Model Context Protocol servers. | Command | Description | | - | - | | `devin mcp add ` | Add a new MCP server | | `devin mcp list` | List all configured MCP servers | | `devin mcp get ` | Show details for a specific MCP server | | `devin mcp remove ` | Remove a configured MCP server | | `devin mcp login ` | Authenticate with an MCP server via OAuth | | `devin mcp logout ` | Remove stored OAuth credentials for an MCP server | **Options for `devin mcp add`:** * `-t, --transport ` — Transport type (optional; inferred from URL → http, trailing args → stdio) * `-s, --scope ` — Configuration scope (default: `local`) * `--url ` — URL for HTTP transport (can also be passed as a positional argument after the name) * `--command ` — Command for stdio transport (optional when trailing args are provided) * `-e, --env ` — Environment variables (repeatable) * `-H, --header ` — HTTP headers (repeatable) * `--scopes ` — OAuth scopes to request (comma-separated) * `` — Positional URL argument for HTTP (alternative to `--url`) * `-- [ARGS...]` — Command and arguments for stdio (first arg is the command when `--command` is omitted) > [!NOTE] > > HTTP servers try Streamable HTTP first and fall back to legacy SSE on 4xx errors (per the [MCP spec](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility)). You can also set `"transport": "sse"` explicitly. See [MCP Configuration → Legacy SSE fallback](https://cli.devin.ai/docs/extensibility/mcp/configuration.md#legacy-sse-fallback). **Examples:** ```bash theme={null} # stdio server devin mcp add my-server -- npx @company/mcp-server --port 3000 # HTTP server (positional URL) devin mcp add notion https://mcp.notion.com/mcp devin mcp add --transport http datadog-mcp https://mcp.datadoghq.com/api/unstable/mcp-server/mcp # HTTP server (--url flag, also works) devin mcp add notion --url https://mcp.notion.com/mcp # With environment variables and scope devin mcp add -e GITHUB_TOKEN=ghp_xxx github -- npx -y @modelcontextprotocol/server-github devin mcp add -s project sentry https://mcp.sentry.dev/mcp ``` **Options for `devin mcp remove`:** * `-s, --scope ` — Configuration scope (default: `local`) **Options for `devin mcp login`:** * `--scopes ` — OAuth scopes to request (comma-separated) See [MCP Configuration](https://cli.devin.ai/docs/extensibility/mcp/configuration.md) for details. ### devin rules Manage agent rules (always-on context blobs). | Command | Description | | - | - | | `devin rules list` | List all available rules | | `devin rules show ` | Show details for a specific rule | | `devin rules paths` | Show rule directory locations | **Options for `devin rules list`:** * `--provider ` — Filter by rule provider See [Rules](https://cli.devin.ai/docs/extensibility/rules.md) for details. ### devin skills Manage agent skills (slash commands and agent-triggered context blobs). | Command | Description | | - | - | | `devin skills list` | List all available skills | | `devin skills show ` | Show details for a specific skill | | `devin skills paths` | Show skill directory locations | **Options for `devin skills list`:** * `--trigger ` — Filter by trigger type See [Skills](https://cli.devin.ai/docs/extensibility/skills/overview.md) for details. ### devin list List sessions in the current directory. Alias: `devin ls` | Command | Description | | - | - | | `devin list` | Interactive session picker (default) | | `devin list --format json` | Output sessions as JSON | | `devin list --format csv` | Output sessions as CSV | ### devin version Print the current version and exit. ```bash theme={null} devin version ``` This is equivalent to `devin --version`. ### devin acp Run Devin as an [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) server over stdio. This subcommand is intended to be invoked by an ACP-aware editor or IDE (such as Windsurf or Zed) as a subprocess — it speaks JSON-RPC over stdin/stdout and is not meant to be run interactively. ```bash theme={null} devin acp ``` The ACP server reads credentials from `WINDSURF_API_KEY` if set, otherwise from the credentials stored by `devin auth login`. It can also accept credentials at runtime via the ACP `authenticate` request. ### devin update Check for updates and optionally install them. ```bash theme={null} devin update ``` Use `--force` to re-install even if already on the latest version: ```bash theme={null} devin update --force ``` ### devin shell \[Feature Preview] Shell integration commands. See [Shell Integration](https://cli.devin.ai/docs/shell-integration.md) for full details. | Command | Description | | - | - | | `devin shell setup` | Install shell integration into your shell config file | | `devin shell setup ` | Install for a specific shell (`bash`, `zsh`, or `fish`) | ### devin setup Interactive setup wizard for authentication and MCP configuration. ```bash theme={null} devin setup devin setup --force-manual-token-flow # For remote/SSH sessions ``` ### devin sandbox \[Research Preview] Manage OS-level process sandboxing for the exec tool. Pass the global `--sandbox` flag to run a session with the sandbox enforced. #### devin sandbox setup Print the sandbox prerequisites for the current platform. Requirements to run with `--sandbox`: * **Linux**: requires bubblewrap (`bwrap`) and `socat`. A sandbox session fails to start with install instructions if either is missing — including in a fresh WSL distribution. * **macOS**: works out of the box via Seatbelt; no extra packages needed. * **Windows**: native Windows cannot run the sandbox. [Install WSL 2](https://learn.microsoft.com/windows/wsl/install) and run Devin inside your WSL distribution. ```bash theme={null} devin sandbox setup ``` ### devin uninstall Uninstall Devin CLI and optionally remove all data. | Option | Description | | - | - | | `--clean` | Remove all data including configuration, history, and custom data | | `--force` | Skip confirmation prompt | *** ## Slash Commands These commands are available inside an interactive session. Type them at the prompt. ### Mode & Model | Command | Description | | | | | - | - | - | - | - | | \`/mode \[normal | accept-edits | plan | bypass]\` | Show or switch the current mode (`autonomous` is available in sandbox sessions) | | `/normal` | Switch to Normal mode (default) | | | | | `/accept-edits` | Switch to Accept Edits mode (auto-approve file edits in workspace) | | | | | `/plan` | Switch to Plan mode (read-only planning) | | | | | `/ask ` | Ask a question without making code changes (oneshot) | | | | | `/bypass` | Switch to Bypass mode (auto-approve all actions) | | | | | `/model [name]` | Show or change the current model | | | | | `/fast` | Switch to SWE-1.6 Fast | | | | | `/theme [dark\|light\|terminal-dark\|terminal-light\|no-color]` | Switch between themes (dark, light, terminal dark, terminal light, no color) | | | | > [!NOTE] > > `/bypass` has aliases `/yolo` and `/dangerous`. All three do the same thing. ### Session Management | Command | Description | | - | - | | `/clear` | Clear conversation history and start a new session. Alias: `/new` | | `/continue [session-id]` | Resume a previous session | | `/fork [step]` | Fork the current session to a new session. Optionally fork from a specific step (see `/steps`). | | `/steps` | List conversation steps (use with `/fork` and `/revert`) | | `/revert ` | Revert file changes from a specific step onwards and rewind the conversation to before that step | | `/resume [session-id]` | Open the interactive session picker, or resume a specific session by ID | | `/ls [--all]` | List recent sessions (current directory only by default). Alias: `/list-sessions` | | `/rename-session ` | Rename the current session | | `/rm-session ` | Irreversibly delete a session and all its data | | `/export` | Show export info. Use the `--export` CLI flag to enable conversation export. | | `/exit` | Exit the application (alias: `/quit`). You can also type `exit` or `quit` without the `/` prefix. | ### Workspace | Command | Description | | - | - | | `/workspace` | List workspace directories (alias: `/workspaces`) | | `/add-dir ` | Add an additional workspace directory | | `/undo-add-dir ` | Remove a workspace directory | ### Automation | Command | Description | | - | - | | `/loop ` | Run a prompt then auto-review the diff in a loop | | `/btw ` | Ask a quick side question. Runs a sidechain using the current conversation context and prints the answer in a box, without adding the question to the main conversation. | ### Extensibility | Command | Description | | - | - | | `/hooks` | List all loaded hooks with their IDs, event types, and source paths | ### Utilities | Command | Description | | - | - | | `/help` | Show available slash commands | | `/bug [description]` | Report a bug to the Devin CLI developers | | `/update [--force]` | Check for and install updates. Pass `--force` to re-install even when already on the latest version. | | `/upgrade` | Upgrade your subscription plan | | `/login` | Authenticate with your account | | `/logout` | Clear stored credentials and exit | | `/context` | Show context window usage | | `/compact` | Force conversation compaction | ### Cloud Sessions (insiders only) | Command | Description | | - | - | | `/cloud-sessions [--all]` | Open an interactive picker of your recent cloud Devin sessions. Use arrow keys to navigate, type to filter, Enter to attach, Esc to cancel. Pass `--all` for org-wide sessions. | | `/cloud-attach ` | Attach to a cloud Devin session with full TUI rendering and bidirectional input. | ### Debug (insiders only) | Command | Description | | - | - | | `/debug-echo ` | Write a raw JSON-RPC body to the ACP transport (stdout). Useful for testing how ACP clients handle specific messages or error conditions. Auto-inserts `"jsonrpc": "2.0"` if missing. | *** ## Modes Modes control the agent's autonomy level by combining a permission mode with an agent profile. > [tab] Normal (default) > > Full autonomy for complex coding tasks. The agent can read, write, and execute commands with normal permission checks. > > * **Permission mode:** Normal > * **Profile:** Normal > * **Use for:** Multi-file refactoring, feature implementation, bug fixes > [tab] Plan > > Planning only — the agent proposes changes without making them. Read-only tool access ensures no code is modified. > > * **Permission mode:** Normal > * **Profile:** Plan (read-only tools) > * **Use for:** Architecture design, understanding codebases, planning before implementation > [tab] Bypass > > All permission prompts are auto-approved. The agent executes freely without asking for confirmation. > > * **Permission mode:** Dangerous > > * **Profile:** Normal > > * **Use for:** Trusted tasks where interruptions slow you down > > > [!WARNING] > > > > Use Bypass mode only for tasks you fully trust. All tool calls (including destructive commands) are auto-approved. Cycle between modes with `/mode`, or switch directly with `/normal`, `/accept-edits`, `/plan`, or `/bypass`. Use `/ask ` as a oneshot command to ask questions without switching modes. *** ## Profiles Profiles determine the agent's available tools and behavior. Profiles are automatically set when you switch modes. | Profile | Description | Tool Access | | - | - | - | | `normal` | Full coding assistant (used by Normal, Accept Edits, and Bypass modes) | All tools | | `plan` | Structured planning workflow (used by Plan mode) | Read-only tools (grep, glob, read, todo, ask\_user\_question, exit\_plan\_mode) | | `ask` | Question answering (used by the `/ask` command) | Read-only tools (grep, glob, read, todo, ask\_user\_question) | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.