Agent Modality

Agent modality provides two distinct ways to work in Warp: a clean terminal for commands, and a dedicated conversation view for multi-turn agent workflows.

Agent modality gives you two distinct ways to work in Warp: a clean terminal for commands, and a dedicated conversation view for multi-turn conversations with Oz, Warp's AI agent.

---

Key terminology

Before diving in, here are two key concepts:

• Terminal session - Your shell environment where you run commands. This is the default mode when you open Warp—a clean, traditional terminal input.

• Oz agent conversation - A multi-turn interaction with Oz. Conversations maintain context across exchanges and have their own dedicated view with richer controls.

Agent modality makes switching between these two contexts seamless while keeping them visually distinct.

---

Why agent modality

Agent modality separates your terminal and agent workflows into distinct modes:

• Clean terminal by default - Minimal input when you're running commands. Agent controls appear only when you need them.

• Dedicated conversation view - Multi-turn agent workflow spaces have full controls like model select, voice input, image attachments, and conversation history.

• Explicit mode switching - The current mode is clearly visible, enabling better workflow organization—you can separate, minimize, and expand different conversations.

---

Two distinct modes

Terminal mode (default)

• Looks and behaves like a traditional terminal input.

• Agent controls are not always visible, keeping the interface clean.

• A message bar shows contextual hints for interacting with agents.

Terminal mode hints

The message bar at the bottom of the terminal provides contextual guidance:

• Default hint - Shows ⌘↩ for new agent when the input is empty.

• Send to agent - Shows ⌘↩ to send to agent when you have text that could be a prompt.

• Error block attachment - When the last command failed, shows a hint to attach the output as agent context (e.g., ⌘↑ attach 'npm install...' output as agent context).

• Attached context indicator - Shows when you have blocks or text selections attached (e.g., ⌘↩ to send to agent with 'git status' attached).

• Continue conversation - When your last visible item is an agent conversation block, shows ⌘Y to continue conversation.

If auto-detection is enabled, Warp labels your input as "agent" or "shell" before you submit, showing "(autodetected)" in magenta. See Understanding auto-detection for configuration and override methods.

The shortcuts shown on this page use macOS keybindings. For Windows and Linux shortcuts, see Keyboard Shortcuts.

Oz agent conversation view (expanded UI)

• A dedicated conversation view with richer agent controls including model select, voice input, image attachments, and conversation management.

• Familiar "charms" (current directory, git branch, diff view entry point, etc.) are still available.

• Designed for multi-turn workflows and managing multiple conversations.

The dedicated Agent Conversation View.

Key difference

Agent controls appear only when you're in a conversation, keeping your terminal clean otherwise.

In the previous UI, agent controls were always present. With agent modality, these controls are hidden by default and appear once you enter an agent conversation.

Agent conversation views are identified with an alternative background color and the input tool belt showing model selector, voice input, and image attachment buttons.

Block origin and visibility

Blocks in Warp belong to either the terminal view or a specific agent conversation:

• Terminal blocks - Commands you run directly in the terminal always appear in your terminal blocklist and can be attached as context to any conversation.

• Agent conversation blocks - Commands executed within an agent conversation (either by you or the agent) only appear within that specific conversation and don't appear in the terminal blocklist.

This separation keeps your terminal view clean while preserving full context within each conversation. For more details, see Blocks as Context.

Cloud agent conversations

In addition to local agent conversations, you can start Oz cloud agent conversations that run in an isolated cloud environment. Cloud agents are useful for:

• Running parallel agents across multiple tasks

• Running agents remotely on hosted computers (offloading compute from your local machine)

• Building agents that run autonomously (ambient agents)

• Checking in on your agents from anywhere

To start a cloud agent conversation, press ⌥⌘↩ (Option+Command+Enter on macOS, or Ctrl+Alt+Enter on Windows/Linux) from terminal mode. You can also use the welcome block's "Start cloud project" action.

Cloud agent conversations have a few differences from local conversations:

• Environment selector - Choose which Warp Environment to run in

• Credits indicator - Shows your remaining cloud agent credits

• Different zero state - The conversation header indicates "New Oz cloud agent conversation"

Cloud agent conversations are always stored in the cloud. For more details on accessing and sharing cloud conversations, see Cloud-synced Conversations.

Accessing running or past cloud conversations:

• From the conversation list panel - Cloud conversations appear alongside local conversations. Click to open.

• From the management view - Use the Agent Management view to see all cloud agent runs, filter by status, and click any row to open the conversation.

• From the Oz web app - Access your cloud agents at oz.warp.dev to manage runs from any browser.

For more on cloud agents, see Cloud Agents Overview.

---

Understanding auto-detection

Auto-detection (which detects whether you're typing natural language or a shell command) helps Warp interpret each input as either a shell command or an agent request. When auto-detection is enabled, Warp shows an inline indicator in the prompt (for example, "(autodetected)" in magenta).

How it works

In terminal mode:

When you type text that appears to be a natural language request (e.g., "Summarize the dependencies in this project"), Warp labels it as "agent" and displays the "(autodetected)" indicator. Pressing Enter will send your input directly to the agent in a new conversation, creating a "quicksend" workflow for text-only requests.

In agent conversation view:

When auto-detection identifies your input as a shell command, Warp displays a distinct UI border around the input to indicate the mode switch. This helps you understand that your input will run as a command rather than being sent to the agent.

Settings

You can control auto-detection separately for terminal mode and agent conversation view:

• Terminal mode: Go to Settings > AI > Input

• Agent conversation view: Go to Settings > AI > Agent modality

Override methods

There are multiple ways to override auto-detection:

• Keyboard shortcut - Press ⌘I to switch between command and agent mode.

• ! prefix - In agent view, prepend ! to your input to force it to run as a shell command (e.g., !ls or !git status).

Common examples:

• You typed something that looks like a command, but you intended an agent request.

• You typed a sentence, but you intended it to run as a command (rare, but it happens).

Note: After you override, the selection is "sticky" for that entry, so you can submit confidently.

Defaults for new vs existing users

Auto-detection is enabled by default for new Warp users. For users who had Warp before agent modality was introduced, auto-detection is disabled by default to preserve their existing workflows.

---

Entering and navigating conversations

How to enter a conversation

There are several ways to start or enter an Oz agent conversation:

A) Use the /agent or /new slash command

Type /agent or /new in terminal mode to enter the agent conversation view. This is the recommended way to explicitly switch to agent mode.

• /agent or /new - Opens a new agent conversation view with full controls

• /agent <prompt> - Sends your prompt directly to the agent in a new conversation

B) Use the keyboard shortcut

Press ⌘↩ (Command+Enter on macOS, or Ctrl+Shift+Enter on Windows/Linux) to enter the conversation view immediately. This is a shortcut for /agent.

Use this when you want to:

• attach an image

• use voice input

• access other conversation-only controls before sending your first message

C) Quicksend with auto-detection

When auto-detection is enabled in terminal mode, you can start a conversation immediately:

1. Type a natural language request (e.g., "Summarize the dependencies in this project").

2. If Warp detects it as an agent request, it shows an "(autodetected)" indicator.

3. Press Enter to send directly to the agent in a new conversation.

This "quicksend" method is useful for quick, text-only requests when you don't need conversation-only controls like voice input or image attachments.

D) Continue from the up-arrow history menu

Press ↑ (up arrow) to open an inline history menu. The menu contents vary by context—see Navigation behavior for details on how up-arrow works in terminal view vs. agent view.

E) Click an active AI suggestion

When Active AI (suggested prompts) is enabled, Warp displays contextual prompt suggestions based on your recent activity. Clicking any of these suggestions opens the agent conversation view and sends that prompt immediately.

---

Navigating conversations

Agent modality introduces the Conversation Panel for browsing and managing your agent conversations. For details on the panel layout, navigation, and conversation storage, see Agent Conversations.

Using slash commands

In an agent conversation

While you're in an agent conversation, you can access Warp's slash commands any time by typing / in the input.

• Type / to open the command menu

• Keep typing to filter commands (for example: /conversations, /compact)

• Use ↑ / ↓ to navigate and Enter to run

• Press esc to dismiss the menu

Key slash commands in agent modality:

• /new or /agent - Start a new conversation.

• /plan or /plan <prompt> - Enter agent view and start a planning conversation. The agent will create an implementation plan before making changes.

• /conversations - Open the conversation list panel.

• /compact - Summarize and compact the current conversation to free up context window space.

• /fork - Fork the current conversation into a new thread. Press Enter to fork in the existing pane, or ⌘↩ (Ctrl+Shift+Enter on Windows/Linux) to fork in a new pane.

• /fork-and-compact - Fork the conversation and automatically summarize it.

• /fork from - Choose a specific point in the conversation to fork from. A menu appears showing your previous queries—select one to fork from that point.

• /model - Select or change the AI model for the conversation.

Slash commands are a quick way to take common actions without leaving the keyboard.

In terminal mode

Slash commands aren't just for agent conversations. You can also type / in terminal mode to open a limited set of commands.

Agent conversations expose the full set of slash commands (including /fork, /compact, and /model). Terminal mode exposes a reduced set focused on quick actions.

For the complete list of available slash commands, see Slash Commands.

Forking conversations

Forking lets you branch off from an existing conversation to explore a different direction without losing your original thread.

How to fork:

1. In an agent conversation, type /fork and press Enter.

2. Choose where to open the forked conversation:

   • Enter - Fork in the current pane (replaces the current view).

   • ⌘↩ (Ctrl+Shift+Enter on Windows/Linux) - Fork in a new pane (keeps the original visible).

Fork and compact:

Use /fork-and-compact to fork and automatically summarize the conversation. This is useful when your context window is getting full but you want to continue building on the same work.

Fork from a specific point:

Use /fork from to choose exactly where in the conversation you want to branch from:

1. Type /fork from and press Enter.

2. A menu shows your previous queries in the conversation.

3. Select the query you want to fork from.

4. Choose Enter (existing pane) or ⌘↩ / Ctrl+Shift+Enter (new pane).

This is helpful when you want to go back to an earlier point and try a different approach.

For more forking methods and use cases, see Conversation Forking.

---

Keyboard shortcuts (quick reference)

In conversation view, press ? to show/hide the full shortcuts panel. Here are the key shortcuts:

Navigation and mode switching

• Start new agent conversation (from terminal mode) - ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux)

• Start new cloud agent conversation (from terminal mode) - ⌥⌘↩ (macOS) / Ctrl+Alt+Enter (Windows/Linux)

• Send to agent with attached context (from terminal mode) - ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux) when blocks are selected

• Tag agent into long-running command - ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux) while an interactive command is running

• Exit conversation (back to terminal mode) - esc

• Stop agent / exit on empty input - ^C / Ctrl+C

• Open conversation selector - ⌘Y (macOS) / Ctrl+Y (Windows/Linux)

• Toggle conversation list panel - ⌘⇧H (macOS) / Ctrl+Shift+H (Windows/Linux)

• Override auto-detection (switch shell ↔ agent) - ⌘I (macOS) / Ctrl+I (Windows/Linux)

Input modifiers

• ! - Prepend to force shell mode (e.g., !ls)

• / - Open slash command menu

• @ - Open context menu (attach files, symbols, etc.)

• ? - Show/hide keyboard shortcuts panel

Conversation actions

• Resume a paused/cancelled conversation - ⌘⇧R (macOS) / Ctrl+Alt+R (Windows/Linux)

• Toggle auto-accept (for agent tool executions) - ⌘⇧I (macOS) / Ctrl+Shift+I (Windows/Linux)

• Open code review pane - ⌘⇧+ (macOS) / Ctrl+Shift++ (Windows/Linux)

• Toggle plan panel (if a plan exists) - ⌘⌥P (macOS) / Ctrl+Alt+P (Windows/Linux)

In slash command / fork menus

• Navigate menu items - ↑ / ↓

• Select (fork in existing pane) - Enter

• Select and open in new pane - ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux)

• Dismiss menu - esc

Customizing keybindings

You can customize keyboard shortcuts for slash commands and other actions in Settings > Keybindings. This lets you assign your preferred key combinations to frequently used commands.

For example, to bind a keyboard shortcut to the /agent slash command:

1. Open Settings > Keybindings

2. Search for "agent" or the slash command you want to bind

3. Click the shortcut field and press your desired key combination

4. The shortcut is saved automatically

This is useful for actions you perform frequently, like starting a new conversation or opening the conversation list.