Skip to main content

​
Usage

devin [OPTIONS] [prompt]
Pass an optional prompt to start a session with an initial message, or launch interactively with no arguments.

​
Global Flags

FlagShortDescription
--model <MODEL>Set the AI model for this session
--permission-mode <MODE>Permission mode (normal, dangerous, bypass)
--continue-cResume the most recent session in the current directory
--resume <SESSION_ID>-rResume a specific session by ID
--print-pPrint response and exit (non-interactive mode)
--prompt-file <FILE>Load the initial prompt from a file
--config <PATH>Configuration file path
--respect-workspace-trustWhether to respect workspace trust settings
Examples: 
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

​
Subcommands

​
devin auth

Manage authentication.
CommandDescription
devin auth loginLog in to your account
devin auth logoutLog out and remove stored credentials
devin auth statusCheck 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

Manage MCP (Model Context Protocol) servers.
CommandDescription
devin mcp add <name>Add a new MCP server
devin mcp listList all configured MCP servers
devin mcp get <name>Show details for a specific MCP server
devin mcp remove <name>Remove a configured MCP server
devin mcp login <name>Authenticate with an MCP server via OAuth
devin mcp logout <name>Remove stored OAuth credentials for an MCP server
Options for devin mcp add:
  • --transport <stdio|sse|http> — Transport type (required)
  • --scope <project|user> — Configuration scope (default: user)
  • --url <URL> — URL for HTTP/SSE transports
  • --command <CMD> — Command for stdio transport
  • --env <KEY=VALUE> — Environment variables (repeatable)
  • --header <HEADER: VALUE> — HTTP headers (repeatable)
  • --scopes <SCOPE,SCOPE> — OAuth scopes to request (comma-separated)
  • -- [ARGS...] — Arguments for stdio command (pass after -- at the end)
Options for devin mcp remove:
  • --scope <project|user> — Configuration scope (default: user)
Options for devin mcp login:
  • --scopes <SCOPE,SCOPE> — OAuth scopes to request (comma-separated)
See MCP Configuration for details.

​
devin rules

Manage agent rules.
CommandDescription
devin rules listList all available rules
devin rules show <name>Show details for a specific rule
devin rules pathsShow rule directory locations
Options for devin rules list:
  • --provider <cursor\|windsurf> — Filter by rule provider
See Rules for details.

​
devin skills

Manage skills.
CommandDescription
devin skills listList all available skills
devin skills show <name>Show details for a specific skill
devin skills pathsShow skill directory locations
Options for devin skills list:
  • --trigger <user\|model> — Filter by trigger type
See Skills for details.

​
devin list

List sessions in the current directory. Alias: devin ls
CommandDescription
devin listInteractive session picker (default)
devin list --format jsonOutput sessions as JSON
devin list --format csvOutput sessions as CSV

​
devin update

Check for updates and optionally install them. 
devin update

​
devin setup

Interactive setup wizard for authentication and MCP configuration. 
devin setup
devin setup --force-manual-token-flow  # For remote/SSH sessions

​
devin uninstall

Uninstall Devin for Terminal and optionally remove all data.
OptionDescription
--cleanRemove all data including configuration, history, and custom data
--forceSkip confirmation prompt

​
Slash Commands

These commands are available inside an interactive session. Type them at the prompt.

​
Mode & Model

CommandDescription
/mode [normal|plan|bypass]Show or switch the current mode
/normalSwitch to Normal mode (default)
/planSwitch to Plan mode (read-only planning)
/bypassSwitch to Bypass mode (auto-approve all actions)
/model [name]Show or change the current model
/themeToggle between light and dark themes
/bypass has aliases /yolo and /dangerous. All three do the same thing.

​
Session Management

CommandDescription
/clearClear conversation history and start a new session
/continue [session-id]Resume a previous session
/forkFork the current session to a new session ID
/ls [--all]List recent sessions (current directory only by default). Alias: /list-sessions
/exitExit the application (alias: /quit). You can also type exit or quit without the / prefix.

​
Workspace

CommandDescription
/workspaceList workspace directories (alias: /workspaces)
/add-dir <path>Add an additional workspace directory

​
Automation

CommandDescription
/loop <prompt>Run a prompt then auto-review the diff in a loop (requires clean git state to start)

​
Extensibility

CommandDescription
/hooksList all loaded hooks with their IDs, event types, and source paths

​
Utilities

CommandDescription
/helpShow available slash commands
/bug [description]Submit a bug report
/updateCheck for and install updates
/upgradeUpgrade your subscription plan
/loginAuthenticate with your account
/logoutClear stored credentials
/compactForce conversation compaction

​
Modes

Modes control the agent’s autonomy level by combining a permission mode with an agent profile.
Full autonomy for complex coding tasks. The agent can read, write, and execute commands with normal permission checks.
  • Permission mode: Normal
  • Profile: Code
  • Use for: Multi-file refactoring, feature implementation, bug fixes
Cycle between modes with /mode, or switch directly with /normal, /plan, or /bypass.

​
Profiles

Profiles determine the agent’s available tools and behavior. Profiles are automatically set when you switch modes.
ProfileDescriptionTool Access
codeFull coding assistant (used by Normal and Bypass modes)All tools
planStructured planning workflow (used by Plan mode)All tools (prompt restricts to read-only)