Using Agents
Use natural language to accomplish any task in the terminal
Last updated
Was this helpful?
Use natural language to accomplish any task in the terminal
Last updated
Was this helpful?
Agent Mode is a mode in Warp that lets you perform any terminal task with natural language. Type the task into your terminal input, press ENTER, and Warp AI runs highly accurate commands tailored to your environment.
Agent Mode can:
Understand plain English (not just commands)
Execute commands and use that output to guide you
Correct itself when it encounters mistakes
Learn and integrate with any service that has public docs or --help
Utilize your saved workflows to answer queries
.
You may enter Agent Mode in a few ways:
Type any natural language, like a task or a question, in the terminal input. Warp will recognize natural language with a local auto-detection feature and prepare to send your query to Warp AI.
Use keyboard shortcuts to toggle into Agent Mode CMD-I or type ASTERISK-SPACE.
Click the “AI” sparkles icon in the menu bar, and this will open a new terminal pane that starts in Agent Mode.
From a block, you want to ask Warp AI about. You can click the sparkles icon in the toolbelt, or click on its block context menu item “Attach block(s) to AI query”.
This will put you in Pair mode by default. While pairing with Warp, you can write out questions and tasks in an ongoing conversation.
When you are in Agent Mode, a ✨ sparkles icon will display in line with your terminal input.
The feature Warp uses to detect natural language automatically is completely local. None of your input is sent to AI unless you press ENTER in Agent Mode.
If you find that certain shell commands are falsely detected as natural language, you can fix the model by adding those commands to a denylist in Settings > AI > Auto-detection denylist.
You may also turn autodetection off from Settings > AI > Input Auto-detection.
The first time you enter Agent Mode, you will be served a banner with the option to disable auto-detection for natural language on your command line:
Warp input occasionally shows hints within the input editor in a light grey text that helps users learn about features. It's enabled by default.
You can quit Agent Mode at any point with ESC or CTRL-C, or toggle out of Agent Mode with CMD-I.
Once you have typed your question or task in the input, press ENTER to execute your AI query. Agent Mode will send your request to Warp AI and begin streaming output in the form of an AI block.
Unlike a chat panel, Agent Mode can complete tasks for you by running commands directly in your session.
If Agent Mode finds a suitable command that will accomplish your task, it will describe the command in the AI block. It will also fill your terminal input with the suggested command so you can press ENTER to run the command.
When you run a command suggested by Agent Mode, that command will work like a standard command you've written in the terminal. No data will be sent back to the AI.
If the suggested command fails and you want to resolve the error, you may start a new AI query to address the problem.
If Agent Mode doesn't have enough context to assist with a task, it will ask permission to run a command and read the output of that command.
You must explicitly agree and press ENTER to run the requested command. When you hit enter, both the command input and the output will be sent to Warp AI.
If you do not wish to send the command or its output to AI, you can click Cancel or press CTRL-C to exit Agent Mode and return to the traditional command line.
Once a requested command is executed, you may click to expand the output and view command details.
In the case that a requested command fails, Warp AI will detect that. Agent Mode is self-correcting. It will request another command until it completes the task for you.
Warp lets you choose from a curated list of LLMs for use in Agent Mode. By default, Warp uses Claude 4 Sonnet for auto, but you can switch to other supported models, including:
OpenAI (General Purpose): GPT-4o, GPT-4.1
OpenAI (Reasoning Models): o3-mini, o3, o4-mini
Anthropic: Claude 4 Sonnet, Claude 3.7 Sonnet, Claude 3.5 Sonnet, Claude 3.5 Haiku
Google: Gemini 2.0 Flash, Gemini 2.5 Pro
Warp saves the data from codebase context to local json files on your computer. You can open the files directly and inspect the full contents in the following location:
Toggle this feature Settings > AI > Show input hint text or search for "Input hint text" in the or Right-click on the input editor.
DeepSeek: R1, V3 (hosted by in the US)
