Usage
Pass an optional prompt to start a session with an initial message, or launch interactively with no arguments.
Global Flags
| Flag | Short | Description |
|---|
--model <MODEL> | | Set the AI model for this session |
--permission-mode <MODE> | | Permission mode (normal, dangerous, bypass) |
--continue | -c | Resume the most recent session in the current directory |
--resume <SESSION_ID> | -r | Resume a specific session by ID |
--print | -p | Print response and exit (non-interactive mode) |
--prompt-file <FILE> | | Load the initial prompt from a file |
--config <PATH> | | Configuration file path |
--respect-workspace-trust | | Whether to respect workspace trust settings |
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.
| 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 |
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.
| Command | Description |
|---|
devin mcp add | Add a new MCP server (interactive wizard) |
devin mcp remove | Remove a configured MCP server |
devin mcp list | List all configured MCP servers |
devin rules
Manage agent rules.
| Command | Description |
|---|
devin rules list | List all available rules |
devin rules show <name> | Show details for a specific rule |
devin rules paths | Show rule directory locations |
devin rules list:
--provider <cursor\|windsurf> — Filter by rule provider
See Rules for details.
devin skills
Manage skills.
| Command | Description |
|---|
devin skills list | List all available skills |
devin skills show <name> | Show details for a specific skill |
devin skills paths | Show skill directory locations |
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
| 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 update
Check for updates and optionally install them.
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.
| 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|plan|bypass] | Show or switch the current mode |
/normal | Switch to Normal mode (default) |
/plan | Switch to Plan mode (read-only planning) |
/bypass | Switch to Bypass mode (auto-approve all actions) |
/model [name] | Show or change the current model |
/theme | Toggle between light and dark themes |
/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 |
/continue [session-id] | Resume a previous session |
/ls [--all] | List recent sessions (current directory only by default) |
/exit | Exit the application (alias: /quit) |
Workspace
| Command | Description |
|---|
/workspace | List workspace directories |
/add-dir <path> | Add an additional workspace directory |
Utilities
| Command | Description |
|---|
/help | Show available slash commands |
/bug [description] | Submit a bug report |
/update | Check for and install updates |
/login | Authenticate with your account |
/logout | Clear stored credentials |
Modes
Modes control the agent’s autonomy level by combining a permission mode with an agent profile.
Normal (default)
Plan
Bypass
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
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
All permission prompts are auto-approved. The agent executes freely without asking for confirmation.
- Permission mode: Dangerous
- Profile: Code
- Use for: Trusted tasks where interruptions slow you down
Use Bypass mode only for tasks you fully trust. All tool calls (including destructive commands) are auto-approved.
/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.
| Profile | Description | Tool Access |
|---|
code | Full coding assistant (used by Normal and Bypass modes) | All tools |
plan | Structured planning workflow (used by Plan mode) | All tools (prompt restricts to read-only) |
