diff --git a/src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx b/src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx index ac8e343f7..16a1a96dd 100644 --- a/src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx +++ b/src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx @@ -39,7 +39,7 @@ Agent Permissions let you define how your Agent in a specific Profile operates **Still getting approval prompts?** If the Agent keeps asking for permission to run certain commands (like `curl`, `rm`, or `wget`) even though you've set permissions to "Always allow," check your **Command denylist** in **Settings** > **Agents** > **Profiles**. The denylist takes precedence over your other permission settings. Remove commands from the denylist to allow them to auto-execute, or use [Run until completion](#run-until-completion) to bypass the denylist for the current task. ::: -You can control how much autonomy the Agent has when performing different types of actions under **Settings** > **Agents** > **Profiles** > **Permissions** . Agent permission types: +You can control how much autonomy the Agent has when performing different types of actions under **Settings** > **Agents** > **Profiles** > **Permissions**. Agent permission types: * Apply code diffs * Read files @@ -121,17 +121,17 @@ To learn how to build and configure your own MCP server, check out the [MCP feat ## Run until completion -During an Agent interaction, you can give the Agent full autonomy for the current task. When auto-approve is on, every suggested command runs immediately until the task finishes, or you stop it with `Ctrl + C`. +During an Agent interaction, you can give the Agent full autonomy for the current task. When auto-approve is on, every suggested command runs immediately until the task finishes, or you stop it with `Ctrl+C`. - Auto-approve all Agent actions with: `CMD + SHIFT + I` + Auto-approve all Agent actions with: `Cmd+Shift+I` - Auto-approve all Agent actions with: `CTRL + SHIFT + I` + Auto-approve all Agent actions with: `Ctrl+Shift+I` - Auto-approve all Agent actions with: `CTRL + SHIFT + I` + Auto-approve all Agent actions with: `Ctrl+Shift+I` diff --git a/src/content/docs/agent-platform/capabilities/codebase-context.mdx b/src/content/docs/agent-platform/capabilities/codebase-context.mdx index 7f4d0b033..e1f11efd3 100644 --- a/src/content/docs/agent-platform/capabilities/codebase-context.mdx +++ b/src/content/docs/agent-platform/capabilities/codebase-context.mdx @@ -32,10 +32,10 @@ git clone https://github.com/vercel/next.js.git && cd next.js ## Indexing your codebase -When you open a directory in Warp, we check if it is part of a Git repository. If it is, Warp begins indexing the source code to provide rich context for Agents. Warp also detects [Git worktree](/code/git-worktrees/) checkouts — each worktree is indexed as its own repository, so Agents always have accurate context for the branch you're working on. +When you open a directory in Warp, Warp checks whether it's part of a Git repository. If it is, Warp begins indexing the source code to provide rich context for Agents. Warp also detects [Git worktree](/code/git-worktrees/) checkouts — each worktree is indexed as its own repository, so Agents always have accurate context for the branch you're working on. :::note -Code indexed with Codebase Context is never stored on our servers. Codebase Context works with both local agent sessions and [cloud agent runs](/platform/). Without Codebase Context enabled, agents will still be able use terminal commands (i.e. `grep`, `sed`) to navigate your code. +Code indexed with Codebase Context is never stored on our servers. Codebase Context works with both local agent sessions and [cloud agent runs](/platform/). Without Codebase Context enabled, agents will still be able to use terminal commands (i.e. `grep`, `sed`) to navigate your code. ::: :::note @@ -43,7 +43,7 @@ Codebase Context works in SSH sessions when [Warp's SSH extension](/terminal/war :::
-![Codebase indexing settings in Warp. Easily track sync status and manage which folders are indexed for AI-powered context and suggestions.](../../../../assets/agent-platform/codebase-context-main.png) +![Codebase indexing settings in Warp, showing sync status and which folders are indexed for AI-powered context and suggestions.](../../../../assets/agent-platform/codebase-context-main.png)
Codebase indexing settings.
@@ -78,7 +78,7 @@ When viewing indexed codebases in Warp under **Settings** > **Code** > **Indexin * **Codebase too large** – The number of files in the codebase exceeds your current plan’s limit. You can either reduce the number of files being indexed using `.warpindexingignore`, or [contact sales](https://www.warp.dev/contact-sales) for support with larger codebases.
-![View and manage the indexing status of your codebases in Warp. Easily see which projects are synced, in progress, or require attention.](../../../../assets/agent-platform/codebase-context-statuses.png) +![View and manage the indexing status of your codebases in Warp, showing which projects are synced, in progress, or require attention.](../../../../assets/agent-platform/codebase-context-statuses.png)
Codebase indexing status overview.
diff --git a/src/content/docs/agent-platform/capabilities/full-terminal-use.mdx b/src/content/docs/agent-platform/capabilities/full-terminal-use.mdx index f4fb8e0f9..e52d69080 100644 --- a/src/content/docs/agent-platform/capabilities/full-terminal-use.mdx +++ b/src/content/docs/agent-platform/capabilities/full-terminal-use.mdx @@ -111,14 +111,14 @@ The behavior differs based on where you start the long-running command: 1. Run an interactive command (e.g., `python`, `psql`) - 2. Press `⌘↩` (macOS) or `Ctrl+Shift+Enter` (Windows/Linux), or use `⌘I` (macOS) / `Ctrl+I` (Windows/Linux), to tag in the agent + 2. Press `⌘+↩` (macOS) or `Ctrl+Shift+Enter` (Windows/Linux), or use `⌘+I` (macOS) / `Ctrl+I` (Windows/Linux), to tag in the agent 3. The input switches to Agent Mode with full controls 4. When you exit, an agent conversation block appears in your terminal block list 5. Click the block to reopen the full conversation with your LRC interaction context 1. The agent runs an interactive command as part of your conversation - 2. Use `⌘↩` (macOS) or `Ctrl+Shift+Enter` (Windows/Linux) to tag in if the agent isn't already interacting + 2. Use `⌘+↩` (macOS) or `Ctrl+Shift+Enter` (Windows/Linux) to tag in if the agent isn't already interacting 3. The UI stays the same since you're already in agent view 4. When you exit, the interaction remains part of your conversation. No separate block is created in the terminal block list 5. Commands run in agent view are automatically included as context @@ -126,7 +126,7 @@ The behavior differs based on where you start the long-running command: :::note -You can also use `CMD + I` (macOS) or `CTRL + I` (Windows/Linux) to toggle agent control in either view. +You can also use `Cmd+I` (macOS) or `Ctrl+I` (Windows/Linux) to toggle agent control in either view. ::: #### Showing and hiding agent responses @@ -135,7 +135,7 @@ Warp gives you control over how much agent output appears in Full Terminal Use. **Toggle visibility** -Use the `Hide responses` or `Show responses` button or `CMD + G` in the interactive command footer to switch between showing all agent output or hiding it from the terminal view. +Use the `Hide responses` or `Show responses` button or `Cmd+G` in the interactive command footer to switch between showing all agent output or hiding it from the terminal view. Note that this only affects the agent's messages and proposals; your terminal state and command output remain unchanged. @@ -156,10 +156,10 @@ You control how much autonomy the agent has when interacting with the terminal. Each time the agent wants to take an action inside an interactive shell, you’ll see the agent’s reasoning, a brief explanation, and the proposed command. From there you can: -* Allow the command once (for example by approving it or pressing `ENTER`). -* Turn on auto-approval for similar commands in this session (for example with `CMD + SHIFT + I`). -* Refine the request with `CTRL + C`, which clears the proposed action and lets you follow up with a different query. -* Take over manually with `CMD + I`, which stops the agent from issuing any further PTY writes until you hand control back. +* Allow the command once (for example by approving it or pressing `Enter`). +* Turn on auto-approval for similar commands in this session (for example with `Cmd+Shift+I`). +* Refine the request with `Ctrl+C`, which clears the proposed action and lets you follow up with a different query. +* Take over manually with `Cmd+I`, which stops the agent from issuing any further PTY writes until you hand control back.
![Allow, Refine, or Take over an agent response.](../../../../assets/agent-platform/allow-refine-takeover.png) diff --git a/src/content/docs/agent-platform/capabilities/mcp.mdx b/src/content/docs/agent-platform/capabilities/mcp.mdx index d6228ef73..80ea6f875 100644 --- a/src/content/docs/agent-platform/capabilities/mcp.mdx +++ b/src/content/docs/agent-platform/capabilities/mcp.mdx @@ -211,7 +211,7 @@ Tip: We've noticed that some models often work better with MCP servers than othe In some cases you may need to reset the auth token for some MCP servers. To do this, delete the local MCP auth files by running the following: `rm -rf ~/.mcp-auth` :::caution -Note this will delete all your MCP auth tokens stored locally so you will need to login and re-authenticate. +Note this will delete all your MCP auth tokens stored locally so you will need to log in and re-authenticate. ::: If the above doesn't help and you need to reset or change authentication, you may need to switch to a CLI-based MCP server configuration and provide the token via environment variables. See [Sentry CLI MCP Example](/agent-platform/capabilities/mcp/#sentry). diff --git a/src/content/docs/agent-platform/capabilities/rules.mdx b/src/content/docs/agent-platform/capabilities/rules.mdx index 9eb1ac089..865c74430 100644 --- a/src/content/docs/agent-platform/capabilities/rules.mdx +++ b/src/content/docs/agent-platform/capabilities/rules.mdx @@ -39,7 +39,7 @@ If both `WARP.md` and `AGENTS.md` exist in the same directory, `WARP.md` takes p ::: :::caution -The filename must be in **all caps** for Warp to recognize it (e.g., `AGENTS.md`, not `agents.md` or `Agents.md`). We recommend creating `AGENTS.md` for new projects. +The filename must be in **all caps** for Warp to recognize it (e.g., `AGENTS.md`, not `agents.md` or `Agents.md`). Create `AGENTS.md` for new projects. ::: **When you're in a directory:** @@ -107,7 +107,7 @@ This ensures the most specific, project-relevant rules take priority over broade #### Project Rules -* **When in a directory, set up Project Rules with a slash command:** Use `/init` in Auto-Detection or Agent Mode to: +* **When in a directory, set up Project Rules with a slash command:** Use `/init` in Auto-detection or Agent Mode to: * Begin indexing your codebase or display indexing status * Generate an `AGENTS.md` file with initial context, or * Link an existing Rules file to `AGENTS.md` @@ -131,4 +131,4 @@ When relevant, Agents automatically pull in applicable rules to guide their resp ### Rules privacy -See our [Privacy page](/support-and-community/privacy-and-security/privacy/) for more information on how we handle data with Rules. +See the [Privacy page](/support-and-community/privacy-and-security/privacy/) for more information on how Warp handles data with Rules. diff --git a/src/content/docs/agent-platform/capabilities/skills.mdx b/src/content/docs/agent-platform/capabilities/skills.mdx index dcffe7050..ded5d81ae 100644 --- a/src/content/docs/agent-platform/capabilities/skills.mdx +++ b/src/content/docs/agent-platform/capabilities/skills.mdx @@ -207,7 +207,7 @@ Skills can be stored at two levels: project-level (accessible only within that p ### Project skills -Project skills live in your repository and are available when you're working in that project. We recommend storing them at your project root, but skills in subdirectories are also discovered when you're working within that subdirectory. This is useful for monorepos with separate `./frontend` and `./backend` directories. +Project skills live in your repository and are available when you're working in that project. Store them at your project root, but skills in subdirectories are also discovered when you're working within that subdirectory. This is useful for monorepos with separate `./frontend` and `./backend` directories. Store them in any of these directories: diff --git a/src/content/docs/agent-platform/cli-agents/claude-code.mdx b/src/content/docs/agent-platform/cli-agents/claude-code.mdx index 9e2936fe4..0cd0aed81 100644 --- a/src/content/docs/agent-platform/cli-agents/claude-code.mdx +++ b/src/content/docs/agent-platform/cli-agents/claude-code.mdx @@ -62,7 +62,7 @@ For plugin source and updates, see the [claude-code-warp GitHub repository](http Claude Code supports the full set of Warp's agent integration features: * **Agent notifications** - Receive in-app and desktop alerts when Claude Code needs your attention. The notification UI displays your current git branch alongside agent status. -* **Rich input editor** - Press `Ctrl-G` to open an expanded input editor for composing longer prompts. +* **Rich input editor** - Press `Ctrl+G` to open an expanded input editor for composing longer prompts. * **Code review** - Send inline review comments directly to the agent from Warp's code review panel. * **Attach code as context** - Select code and send it to the agent as context. * **Vertical tabs with agent metadata** - Monitor Claude Code sessions with status indicators in Warp's tab bar. diff --git a/src/content/docs/agent-platform/cli-agents/codex.mdx b/src/content/docs/agent-platform/cli-agents/codex.mdx index 401fdc42a..690ca2bca 100644 --- a/src/content/docs/agent-platform/cli-agents/codex.mdx +++ b/src/content/docs/agent-platform/cli-agents/codex.mdx @@ -37,7 +37,7 @@ Then restart Codex. If this config isn't set, Warp displays a setup chip in the Codex supports the full set of Warp's agent integration features: * **Agent notifications** - Receive in-app and desktop alerts when Codex needs your attention. Requires a one-time config change (see [Setting up notifications](#setting-up-notifications)). -* **Rich input editor** - Press `Ctrl-G` to open an expanded input editor for composing longer prompts. +* **Rich input editor** - Press `Ctrl+G` to open an expanded input editor for composing longer prompts. * **Code review** - Send inline review comments directly to the agent from Warp's code review panel. * **Attach code as context** - Select code and send it to the agent as context. * **Vertical tabs with agent metadata** - Monitor Codex sessions with status indicators in Warp's tab bar. diff --git a/src/content/docs/agent-platform/cli-agents/opencode.mdx b/src/content/docs/agent-platform/cli-agents/opencode.mdx index e4c94a96d..2a67be3ea 100644 --- a/src/content/docs/agent-platform/cli-agents/opencode.mdx +++ b/src/content/docs/agent-platform/cli-agents/opencode.mdx @@ -34,7 +34,7 @@ For plugin source and updates, see the [opencode-warp GitHub repository](https:/ OpenCode supports the full set of Warp's agent integration features: * **Agent notifications** - Receive in-app and desktop alerts when OpenCode needs your attention. The notification UI displays your current git branch alongside agent status. -* **Rich input editor** - Press `Ctrl-G` to open an expanded input editor for composing longer prompts. +* **Rich input editor** - Press `Ctrl+G` to open an expanded input editor for composing longer prompts. * **Code review** - Send inline review comments directly to the agent from Warp's code review panel. * **Attach code as context** - Select code and send it to the agent as context. * **Vertical tabs with agent metadata** - Monitor OpenCode sessions with status indicators in Warp's tab bar. diff --git a/src/content/docs/agent-platform/cli-agents/overview.mdx b/src/content/docs/agent-platform/cli-agents/overview.mdx index 915e2f0fc..64e8a7583 100644 --- a/src/content/docs/agent-platform/cli-agents/overview.mdx +++ b/src/content/docs/agent-platform/cli-agents/overview.mdx @@ -47,7 +47,7 @@ Not every feature is available for every agent. The table below shows current su | Feature                               | Claude Code | Codex | OpenCode | Amp | Auggie | Copilot CLI | Cursor | Gemini CLI | Droid | Pi | |---|---|---|---|---|---|---|---|---|---|---| -| Rich input editor (`Ctrl-G`) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | +| Rich input editor (`Ctrl+G`) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | Agent notifications | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | | Code review comments | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | Attach code as context | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | diff --git a/src/content/docs/agent-platform/cli-agents/rich-input.mdx b/src/content/docs/agent-platform/cli-agents/rich-input.mdx index f26ab4882..de0f39987 100644 --- a/src/content/docs/agent-platform/cli-agents/rich-input.mdx +++ b/src/content/docs/agent-platform/cli-agents/rich-input.mdx @@ -6,7 +6,7 @@ description: >- --- import VideoEmbed from '@components/VideoEmbed.astro'; -Warp's rich input editor lets you write prompts for any CLI coding agent with the same editing experience you'd expect from an IDE — mouse support, context attachment, voice, and more. Press `Ctrl-G` (configurable) or click the **Rich Input** button in the agent utility bar to open it. +Warp's rich input editor lets you write prompts for any CLI coding agent with the same editing experience you'd expect from an IDE — mouse support, context attachment, voice, and more. Press `Ctrl+G` (configurable) or click the **Rich Input** button in the agent utility bar to open it. @@ -22,7 +22,7 @@ Warp's rich input editor lets you write prompts for any CLI coding agent with th There are two ways to open the rich input editor: -1. **Keyboard shortcut** - Press `Ctrl-G` (configurable) while a supported agent is running in the active pane. +1. **Keyboard shortcut** - Press `Ctrl+G` (configurable) while a supported agent is running in the active pane. 2. **Rich Input button** - Click the **Rich Input** button in the agent utility bar at the bottom of the pane.
@@ -46,7 +46,7 @@ In the Warp app, go to **Settings** > **Agents** > **Third party CLI agents** to * **Auto show/hide based on agent status** - Automatically open the rich input editor when the agent needs input, and hide it when the agent is working. Works with agents that have plugin support and the plugin installed (Claude Code and OpenCode). * **Auto open on session start** - Automatically open the rich input editor when a CLI agent session starts. * **Auto dismiss after submission** - Close the editor after you send a prompt. -* **Keyboard shortcut** - The default shortcut is `Ctrl-G`. Customize this in **Settings** > **Keyboard shortcuts**. +* **Keyboard shortcut** - The default shortcut is `Ctrl+G`. Customize this in **Settings** > **Keyboard shortcuts**. * **Disable the Rich Input button** - Right-click the agent utility bar and remove the **Rich Input** chip, or disable the footer entirely in **Settings** > **Agents** > **Third party CLI agents**.
diff --git a/src/content/docs/agent-platform/getting-started/faqs.mdx b/src/content/docs/agent-platform/getting-started/faqs.mdx index 4d0a5ef34..973db259b 100644 --- a/src/content/docs/agent-platform/getting-started/faqs.mdx +++ b/src/content/docs/agent-platform/getting-started/faqs.mdx @@ -13,7 +13,7 @@ Answers to frequently asked questions about Warp's agents, including supported m ### What data is sent and/or stored when using Agents in Warp? -See our [Privacy page](/support-and-community/privacy-and-security/privacy/) for more information on how we handle data used by Agents in Warp. +See the [Privacy page](/support-and-community/privacy-and-security/privacy/) for more information on how Warp handles data used by Agents in Warp. ### What happened to the old Warp AI chat panel? @@ -21,7 +21,7 @@ Agent Mode has replaced the previous AI chat panel. Agent Mode is more powerful ### Is my data used for model training? -Warp reserves the right to use data collected to train models and improve Warp. Warp has Zero Data Retention with all its model providers (e.g. Anthropic, OpenAI, etc.). Please learn more about telemetry in our [Privacy page](/support-and-community/privacy-and-security/privacy/). +Warp reserves the right to use data collected to train models and improve Warp. Warp has Zero Data Retention with all its model providers (e.g. Anthropic, OpenAI, etc.). Learn more about telemetry in the [Privacy page](/support-and-community/privacy-and-security/privacy/). ### What model are you using for Agent Mode? diff --git a/src/content/docs/agent-platform/local-agents/active-ai.mdx b/src/content/docs/agent-platform/local-agents/active-ai.mdx index 5c5e50fa7..929c903d2 100644 --- a/src/content/docs/agent-platform/local-agents/active-ai.mdx +++ b/src/content/docs/agent-platform/local-agents/active-ai.mdx @@ -21,7 +21,7 @@ To disable, please visit **Settings** > **Agents** > **Warp Agent** > **Active A #### Accepting a prompt suggestion -If you press `CTRL-ENTER` (on macOS), `ALT-SHIFT-ENTER` (on Linux/Windows), or click on the chip, the suggestion will auto-populate into your input and run against [Agent Mode](/agent-platform/local-agents/interacting-with-agents/) (with the most recent block attached). +If you press `Ctrl+Enter` (on macOS), `Alt+Shift+Enter` (on Linux/Windows), or click on the chip, the suggestion will auto-populate into your input and run against [Agent Mode](/agent-platform/local-agents/interacting-with-agents/) (with the most recent block attached). :::note Prompt Suggestions use an LLM to generate prompts based on your terminal session, specifically the most recent block. These AI requests do not contribute towards your AI limits, however, any accepted prompts run in Agent Mode contribute as normal. Visit **Settings** > **Agents** > **Warp Agent** > **Active AI** if you'd like to turn it off. @@ -47,7 +47,7 @@ Next Command is an LLM-based feature that uses your command history (enriched wi #### Accepting Next Command suggestions -Press `→` or `CTRL-F` to accept a Next Command suggestion into your input buffer, then press `ENTER` to execute it. You can change the accept keybinding (for example, to `TAB`) via the inline keybinding picker that appears next to the suggestion. +Press `→` or `Ctrl+F` to accept a Next Command suggestion into your input buffer, then press `Enter` to execute it. You can change the accept keybinding (for example, to `Tab`) via the inline keybinding picker that appears next to the suggestion. #### Billing @@ -59,15 +59,15 @@ Suggested Code Diffs automatically surface potential fixes for command-line erro !["Generating fix" banner shown after a command-line error while Warp prepares a proposed diff.](../../../../assets/agent-platform/suggested-code-diffs-generating-fix.png) -When an error occurs, Warp evaluates whether it is appropriate for an LLM to generate a fix. If so, a “Generating fix” banner will appear while Warp prepares a proposed diff. You can stop this process at any time by pressing `CTRL + C` or the stop button. +When an error occurs, Warp evaluates whether it is appropriate for an LLM to generate a fix. If so, a “Generating fix” banner will appear while Warp prepares a proposed diff. You can stop this process at any time by pressing `Ctrl+C` or the stop button. ![Suggested code diff with options to dismiss or accept the proposed fix.](../../../../assets/agent-platform/suggested-code-diffs.png) #### Using a suggested code diff -Once the diff is generated, you can either dismiss it or accept it. Acceptance can be done directly via the buttons in the diff view, or with `CMD + ENTER` on macOS and `CTRL + ENTER` on Windows/Linux. +Once the diff is generated, you can either dismiss it or accept it. Acceptance can be done directly via the buttons in the diff view, or with `Cmd+Enter` on macOS and `Ctrl+Enter` on Windows/Linux. -You can also view additional details of the diff by pressing `CMD + E` (macOS) or `CTRL + E` (Windows/Linux), which expands the view to allow further inspection (including refining or editing it). You can also use `↓` to view the entire diff. +You can also view additional details of the diff by pressing `Cmd+E` (macOS) or `Ctrl+E` (Windows/Linux), which expands the view to allow further inspection (including refining or editing it). You can also use `↓` to view the entire diff. **Billing** @@ -75,4 +75,4 @@ Suggested Code Diffs do not count toward your AI request limits. There are maxim ## Active AI privacy -See our [Privacy page](/support-and-community/privacy-and-security/privacy/) for more information on how we handle data with Active AI. +See the [Privacy page](/support-and-community/privacy-and-security/privacy/) for more information on how Warp handles data with Active AI. diff --git a/src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx b/src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx index dfe3f2ca1..0f9928ede 100644 --- a/src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx +++ b/src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx @@ -27,46 +27,46 @@ The most common use case is to ask the AI to fix an error. You can attach the er **Attach a previous block** - * To attach blocks to a query, you can use `CMD-UP` to attach the previous block as context to the query. While holding `CMD`, you can then use your `UP/DOWN` keys to pick another block to attach. - * You may also use your mouse to attach blocks in your session. Hold `CMD` as you click on other blocks to extend your block selection. + * To attach blocks to a query, you can use `Cmd+Up` to attach the previous block as context to the query. While holding `Cmd`, you can then use your `Up`/`Down` keys to pick another block to attach. + * You may also use your mouse to attach blocks in your session. Hold `Cmd` as you click on other blocks to extend your block selection. **Clear a previous block** - * To clear blocks from a query, you can use `CMD-DOWN` until the blocks are removed from context. - * You may also use your mouse to clear blocks in your session. Hold `CMD` as you click on an attached block to clear it. + * To clear blocks from a query, you can use `Cmd+Down` until the blocks are removed from context. + * You may also use your mouse to clear blocks in your session. Hold `Cmd` as you click on an attached block to clear it. :::note - When using "Pin to the top" [Input Position](/terminal/appearance/input-position/), the direction for attaching or detaching is reversed (i.e. `CMD-DOWN` attaches blocks to context, while `CMD-UP` clears blocks from context). + When using "Pin to the top" [Input Position](/terminal/appearance/input-position/), the direction for attaching or detaching is reversed (i.e. `Cmd+Down` attaches blocks to context, while `Cmd+Up` clears blocks from context). ::: **Attach a previous block** - * To attach blocks to a query, you can use `CTRL-UP` to attach the previous block as context to the query. While holding `CTRL`, you can then use your `UP/DOWN` keys to pick another block to attach. - * You may also use your mouse to select blocks in your session. Hold `CTRL` as you click on other blocks to extend your block selection. + * To attach blocks to a query, you can use `Ctrl+Up` to attach the previous block as context to the query. While holding `Ctrl`, you can then use your `Up`/`Down` keys to pick another block to attach. + * You may also use your mouse to select blocks in your session. Hold `Ctrl` as you click on other blocks to extend your block selection. **Clear a previous block** - * To clear blocks from a query, you can use `CTRL-DOWN` until the blocks are removed from context. - * You may also use your mouse to clear blocks in your session. Hold `CTRL` as you click on an attached block to clear it. + * To clear blocks from a query, you can use `Ctrl+Down` until the blocks are removed from context. + * You may also use your mouse to clear blocks in your session. Hold `Ctrl` as you click on an attached block to clear it. :::note - When using "Pin to the top" [Input Position](/terminal/appearance/input-position/), the direction for attaching or detaching is reversed (i.e. `CTRL-DOWN` attaches blocks to context, while `CTRL-UP` clears blocks from context). + When using "Pin to the top" [Input Position](/terminal/appearance/input-position/), the direction for attaching or detaching is reversed (i.e. `Ctrl+Down` attaches blocks to context, while `Ctrl+Up` clears blocks from context). ::: **Attach a previous block** - * To attach blocks to a query, you can use `CTRL-UP` to attach the previous block as context to the query. While holding `CTRL`, you can then use your `UP/DOWN` keys to pick another block to attach. - * You may also use your mouse to select blocks in your session. Hold `CTRL` as you click on other blocks to extend your block selection. + * To attach blocks to a query, you can use `Ctrl+Up` to attach the previous block as context to the query. While holding `Ctrl`, you can then use your `Up`/`Down` keys to pick another block to attach. + * You may also use your mouse to select blocks in your session. Hold `Ctrl` as you click on other blocks to extend your block selection. **Clear a previous block** - * To clear blocks from a query, you can use `CTRL-DOWN` until the blocks are removed from context. - * You may also use your mouse to clear blocks in your session. Hold `CTRL` as you click on an attached block to clear it. + * To clear blocks from a query, you can use `Ctrl+Down` until the blocks are removed from context. + * You may also use your mouse to clear blocks in your session. Hold `Ctrl` as you click on an attached block to clear it. :::note - When using "Pin to the top" [Input Position](/terminal/appearance/input-position/), the direction for attaching or detaching is reversed (i.e. `CTRL-DOWN` attaches blocks to context, while `CTRL-UP` clears blocks from context). + When using "Pin to the top" [Input Position](/terminal/appearance/input-position/), the direction for attaching or detaching is reversed (i.e. `Ctrl+Down` attaches blocks to context, while `Ctrl+Up` clears blocks from context). ::: @@ -101,5 +101,5 @@ You can also manually attach terminal view blocks to add additional context from When you select blocks in terminal view and start a new conversation, those blocks become **pending context**: -* **Pending context** - Blocks are selected but the conversation hasn't started yet. If you deselect the blocks (`ESC` or `CMD-K` on macOS, `ESC` or `CTRL-K` on Windows/Linux), they're removed from the agent view. +* **Pending context** - Blocks are selected but the conversation hasn't started yet. If you deselect the blocks (`Esc` or `Cmd+K` on macOS, `Esc` or `Ctrl+K` on Windows/Linux), they're removed from the agent view. * **Attached context** - Once you submit your first query, the pending blocks become attached to the conversation and remain part of the context. diff --git a/src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx b/src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx index cc4776a0c..706e47002 100644 --- a/src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx +++ b/src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx @@ -12,7 +12,7 @@ Attach text selections or diff hunks directly from Warp's code editor or Code Re When you have Warp’s [native code editor](/code/code-editor/) open beside a regular pane, you can easily attach specific lines of code as context: 1. **Select text** in the editor. A tooltip will appear in the bottom-right corner of the selection. -2. **Add as context** by clicking the tooltip or using the keyboard shortcuts `Cmd + L` (macOS) or `CTRL + SHIFT + L` (Windows or Linux). +2. **Add as context** by clicking the tooltip or using the keyboard shortcuts `Cmd+L` (macOS) or `Ctrl+Shift+L` (Windows or Linux). 3. Warp automatically adds the relative file path and context, in addition to the line numbers of the hunk, as a formatted string into the prompt. This makes it easy to highlight just the lines you want the Agent to analyze or modify. @@ -40,6 +40,6 @@ This helps the Agent understand exactly what has been modified, making it easier You can select code, files, or snippets and feed them directly to a running third-party CLI agent session without copy-pasting or switching tools. -When a third-party agent (Claude Code, Codex, OpenCode, etc.) is running in a Warp tab, select text in Warp's code editor or Code Review panel and attach it as context to that agent's session using `Cmd + L` (macOS) or `CTRL + SHIFT + L` (Windows/Linux). This works the same way as attaching context to Warp's built-in Agent. +When a third-party agent (Claude Code, Codex, OpenCode, etc.) is running in a Warp tab, select text in Warp's code editor or Code Review panel and attach it as context to that agent's session using `Cmd+L` (macOS) or `Ctrl+Shift+L` (Windows/Linux). This works the same way as attaching context to Warp's built-in Agent. For more on third-party agent support, see [Third-party CLI agents](/agent-platform/cli-agents/overview/). diff --git a/src/content/docs/agent-platform/local-agents/cloud-conversations.mdx b/src/content/docs/agent-platform/local-agents/cloud-conversations.mdx index 552a0c36a..abfaa47de 100644 --- a/src/content/docs/agent-platform/local-agents/cloud-conversations.mdx +++ b/src/content/docs/agent-platform/local-agents/cloud-conversations.mdx @@ -122,7 +122,7 @@ When cloud conversation storage is disabled by your organization: Cloud conversation storage limits vary by plan. For free users, Warp automatically removes the oldest cloud conversations when you reach your limit to make room for new ones. Your conversations are always preserved locally on your machine—only the cloud-synced copies are removed. -For current storage limits by plan, see our [pricing page](https://www.warp.dev/pricing). +For current storage limits by plan, see the [pricing page](https://www.warp.dev/pricing). ### Deleting conversations diff --git a/src/content/docs/agent-platform/local-agents/code-diffs.mdx b/src/content/docs/agent-platform/local-agents/code-diffs.mdx index 0c0b167ae..ff221612b 100644 --- a/src/content/docs/agent-platform/local-agents/code-diffs.mdx +++ b/src/content/docs/agent-platform/local-agents/code-diffs.mdx @@ -35,9 +35,9 @@ You can also choose whether Warp automatically opens the [Code Review](/code/cod When an Agent generates a code diff, Warp opens it in a built-in text editor with a visual diff view. Changes are grouped into clear hunks for easy inspection. -* Use the `UP` and `DOWN` arrow keys (or mouse clicks) to move between hunks. -* For multi-file changes, use `LEFT` and `RIGHT` arrow keys to switch between files. -* Once satisfied with the changes, you can apply the diffs using `ENTER` or clicking "**Accept Changes**" to apply the modifications. +* Use the `↑` and `↓` arrow keys (or mouse clicks) to move between hunks. +* For multi-file changes, use `←` and `→` arrow keys to switch between files. +* Once satisfied with the changes, you can apply the diffs using `Enter` or clicking "**Accept Changes**" to apply the modifications. :::caution These modifications will not be applied to the files unless you explicitly accept them. @@ -49,7 +49,7 @@ If the initial suggestion needs more work: * Press `R` or select the "**Refine**" button to provide follow-up instructions in natural language. The agent will regenerate the diff based on your input. * To manually adjust the code, press `E` or click "**Edit**" to switch into an editable view. -* To cancel a pending operation, use `CTRL-C` (on macOS, Windows, or Linux). Similarly, you can exit the editor at any time with `ESC`. +* To cancel a pending operation, use `Ctrl+C` (on macOS, Windows, or Linux). Similarly, you can exit the editor at any time with `Esc`. :::note You can open up code files in Warp in various different ways, refer to: [Opening files in Warp](/code/code-editor/#opening-files-in-warp) diff --git a/src/content/docs/agent-platform/local-agents/generate.mdx b/src/content/docs/agent-platform/local-agents/generate.mdx index 6c38c1342..2b6109103 100644 --- a/src/content/docs/agent-platform/local-agents/generate.mdx +++ b/src/content/docs/agent-platform/local-agents/generate.mdx @@ -33,7 +33,7 @@ Type `#` on the command-line input to generate command suggestions. -1. Press `` CTRL-` `` or type `#` into the text input editor to search using natural language. +1. Press `` Ctrl+` `` or type `#` into the text input editor to search using natural language. 2. Type in the input box what you'd like to do. For example, "replace a string in a file." 3. Results are generated in real-time, and you can keep the current prompt or modify the prompt to generate new commands. 4. When you've found the command you want to execute, it can be run or saved as a Workflow onto Warp Drive to easily recall it in the future. @@ -41,7 +41,7 @@ Type `#` on the command-line input to generate command suggestions. ### \[Legacy] Generate text and contextual suggestions in interactive CLIs :::caution -**Our legacy Generate feature which works in interactive CLIs has been replaced by** [Full Terminal Use](/agent-platform/capabilities/full-terminal-use/)**, where Warp's agent can now run and control long-running or full-screen terminal applications**.\ +**The legacy Generate feature which works in interactive CLIs has been replaced by** [Full Terminal Use](/agent-platform/capabilities/full-terminal-use/)**, where Warp's agent can now run and control long-running or full-screen terminal applications**.\ The agent can provide input when prompted, navigate interactive screens, and continue execution without stalling. ::: @@ -59,24 +59,24 @@ In interactive CLI applications, you can generate input using natural language. - 1. Inside a long-running, interactive command, press `CMD-I` when you see the hint text appear. + 1. Inside a long-running, interactive command, press `Cmd+I` when you see the hint text appear. 2. Type what you would like to generate in the input box. For example, "show me all tables in my Postgres database" or in Vim, "generate a recursive Fibonacci function and save it to the file." 3. Results are generated in real time using the [LLM of your choice](/agent-platform/local-agents/generate/#supported-interactive-cli-models). - 4. To refine or follow up on your query, press `CMD-Y`. You can then either edit your last message by pressing `UP ↑` or add a follow-up by typing in new text. + 4. To refine or follow up on your query, press `Cmd+Y`. You can then either edit your last message by pressing `↑` or add a follow-up by typing in new text. 5. When you've found the text you want to add or execute, press `Enter` or click the Accept button. - 1. Inside a long-running, interactive command, press `CTRL-SHIFT-I` when you see the hint text appear. + 1. Inside a long-running, interactive command, press `Ctrl+Shift+I` when you see the hint text appear. 2. Type what you would like to generate in the input box. For example, "show me all tables in my Postgres database" or in Vim, "generate a recursive Fibonacci function and save it to the file." 3. Results are generated in real time using the [LLM of your choice](/agent-platform/local-agents/generate/#supported-interactive-cli-models) - 4. To refine or follow up on your query, press `CTRL-SHIFT-Y`. You can then either edit your last message by pressing `UP ↑` or add a follow-up by typing in new text. + 4. To refine or follow up on your query, press `Ctrl+Shift+Y`. You can then either edit your last message by pressing `↑` or add a follow-up by typing in new text. 5. When you've found the text you want to add or execute, press `Enter` or click the Accept button. - 1. Inside a long-running, interactive command, press `CTRL-SHIFT-I` when you see the hint text appear. + 1. Inside a long-running, interactive command, press `Ctrl+Shift+I` when you see the hint text appear. 2. Type what you would like to generate in the input box. For example, "show me all tables in my Postgres database" or in Vim, "generate a recursive Fibonacci function and save it to the file." 3. Results are generated in real time using the [LLM of your choice](/agent-platform/local-agents/generate/#supported-interactive-cli-models) - 4. To refine or follow up on your query, press `CTRL-SHIFT-Y`. You can then either edit your last message by pressing `UP ↑` or add a follow-up by typing in new text. + 4. To refine or follow up on your query, press `Ctrl+Shift+Y`. You can then either edit your last message by pressing `↑` or add a follow-up by typing in new text. 5. When you've found the text you want to add or execute, press `Enter` or click the Accept button. diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx index 457a3baaa..8e1a4668f 100644 --- a/src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx +++ b/src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx @@ -25,7 +25,7 @@ There are five ways to fork an existing conversation: #### 1. From the Command Palette -Open the menu using the Command Palette (`CMD + Y` on macOS / `CTRL + SHIFT + Y` on Windows/Linux). +Open the menu using the Command Palette (`Cmd+Y` on macOS / `Ctrl+Shift+Y` on Windows/Linux). Select **Fork current conversation** to fork your current conversation, or fork a specific conversation from open conversations. diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx index 5a737ff55..b5dfaa855 100644 --- a/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx +++ b/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx @@ -33,7 +33,7 @@ By default, if you ask an AI query immediately after interacting in Agent Mode, **To follow-up on a previous conversation:** * Simply continue prompting the agent if you are already in an active conversation. -* Open the **Conversations menu** (`CMD + Y` on macOS, `CTRL + SHIFT + Y` on Windows/Linux), select a conversation, and then enter your query. +* Open the **Conversations menu** (`Cmd+Y` on macOS, `Ctrl+Shift+Y` on Windows/Linux), select a conversation, and then enter your query. * Alternatively, click the pink conversation chip in the input field to resume. You don't have to wait for the agent to finish before lining up your next prompt. With [prompt queueing](/agent-platform/local-agents/interacting-with-agents/prompt-queueing/), you can queue follow-ups while the agent is still responding and have them send automatically in order. @@ -57,11 +57,11 @@ While Warp’s agent is thinking and processing your request, Warp may surface s You can enable or disable these tips in two places: * **Settings**: **Settings** > **Agents** > **Warp Agent** > **Input** > **Show agent tips** -* **Command Palette**: Open the Command Palette (`CMD + P` on macOS, `CTRL + SHIFT + P` on Windows/Linux), then select "**Show Agent Tips**" or "**Hide Agent Tips**" +* **Command Palette**: Open the Command Palette (`Cmd+P` on macOS, `Ctrl+Shift+P` on Windows/Linux), then select "**Show Agent Tips**" or "**Hide Agent Tips**" ### Managing conversations -You can view previous conversations or start a new conversation via the **Conversations Menu** (`CMD + Y` on macOS, `CTRL + SHIFT + Y` on Windows/Linux). +You can view previous conversations or start a new conversation via the **Conversations Menu** (`Cmd+Y` on macOS, `Ctrl+Shift+Y` on Windows/Linux). @@ -82,23 +82,23 @@ Visual indicators differ slightly depending on input mode: You can also start a new conversation manually at any time: - * In **Classic Input**, press `CMD + I` or press `BACKSPACE` while in follow-up mode. - * In **Terminal and Agent modes**, press `CMD + ↵` to start a new conversation, or use the `/new` slash command. - * Open the **Conversations Menu** using `CMD + Y` and select "New Conversation". + * In **Classic Input**, press `Cmd+I` or press `Backspace` while in follow-up mode. + * In **Terminal and Agent modes**, press `Cmd+↵` to start a new conversation, or use the `/new` slash command. + * Open the **Conversations Menu** using `Cmd+Y` and select "New Conversation". You can also start a new conversation manually at any time: - * In **Classic Input**, press `CTRL + I` or press `BACKSPACE` while in follow-up mode. - * In **Terminal and Agent modes**, press `CTRL + SHIFT + ↵` to start a new conversation, or use the `/new` slash command. - * Open the **Conversations Menu** using `CTRL + SHIFT + Y` and select "New Conversation". + * In **Classic Input**, press `Ctrl+I` or press `Backspace` while in follow-up mode. + * In **Terminal and Agent modes**, press `Ctrl+Shift+↵` to start a new conversation, or use the `/new` slash command. + * Open the **Conversations Menu** using `Ctrl+Shift+Y` and select "New Conversation". You can also start a new conversation manually at any time: - * In **Classic Input**, press `CTRL + I` or press `BACKSPACE` while in follow-up mode. - * In **Terminal and Agent modes**, press `CTRL + SHIFT + ↵` to start a new conversation, or use the `/new` slash command. - * Open the **Conversations Menu** using `CTRL + SHIFT + Y` and select "New Conversation". + * In **Classic Input**, press `Ctrl+I` or press `Backspace` while in follow-up mode. + * In **Terminal and Agent modes**, press `Ctrl+Shift+↵` to start a new conversation, or use the `/new` slash command. + * Open the **Conversations Menu** using `Ctrl+Shift+Y` and select "New Conversation". @@ -152,19 +152,19 @@ You can also create a new conversation manually at any time by using the keyboar - * Start a new conversation: `CMD + SHIFT + N` - * Open a new tab: `CMD + T` - * Open a new pane: `CMD + D` + * Start a new conversation: `Cmd+Shift+N` + * Open a new tab: `Cmd+T` + * Open a new pane: `Cmd+D` - * Start a new conversation: `CTRL + SHIFT + N` - * Open a new tab: `CTRL + SHIFT + T` - * Open a new pane: `CTRL + SHIFT + D` + * Start a new conversation: `Ctrl+Shift+N` + * Open a new tab: `Ctrl+Shift+T` + * Open a new pane: `Ctrl+Shift+D` - * Start a new conversation: `CTRL + SHIFT + N` - * Open a new tab: `CTRL + SHIFT + T` - * Open a new pane: `CTRL + SHIFT + D` + * Start a new conversation: `Ctrl+Shift+N` + * Open a new tab: `Ctrl+Shift+T` + * Open a new pane: `Ctrl+Shift+D` @@ -232,7 +232,7 @@ Navigation between [Terminal and Agent modes](/agent-platform/local-agents/inter * **Clicking an active conversation** - Takes you directly to that conversation view. * **Clicking a past conversation** - Opens the conversation in a **new pane**, preserving your current context. * **Command Palette** - Open the Command Palette and type `conversations:` to filter and navigate directly to any conversation. -* **`⌘Y` conversation selector** - Opens a dedicated menu showing your existing and past conversations. This works in both terminal view and agent view. +* **`⌘+Y` conversation selector** - Opens a dedicated menu showing your existing and past conversations. This works in both terminal view and agent view. * **Up-arrow history** - Shows both past shell commands and past prompts you've sent in recent conversations. The behavior differs by context: * **In terminal view** - Shows both past shell commands and recent conversations. * **In agent view** - Shows past prompts you've sent in conversations. @@ -241,14 +241,14 @@ Navigation between [Terminal and Agent modes](/agent-platform/local-agents/inter ### Ways to move around -Use `esc` or the back button to return to terminal mode, `⌘Y` to open the conversation selector, or `⌘↩` to start a new conversation. For a complete list of keyboard shortcuts and slash commands, see [Terminal and Agent modes - Keyboard shortcuts](/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes/#keyboard-shortcuts-quick-reference). +Use `Esc` or the back button to return to terminal mode, `⌘+Y` to open the conversation selector, or `⌘+↩` to start a new conversation. For a complete list of keyboard shortcuts and slash commands, see [Terminal and Agent modes - Keyboard shortcuts](/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes/#keyboard-shortcuts-quick-reference). ### Exit confirmation for in-progress conversations Exiting a conversation that is still in progress will **cancel** the agent's current work. To prevent accidental cancellations, Warp shows a confirmation hint: * **First exit attempt** - The hint changes to "Press again to exit" (or similar). -* **Confirmation window** - You have about 2 seconds to press `esc` or `^C` again to confirm. +* **Confirmation window** - You have about 2 seconds to press `Esc` or `^C` again to confirm. * **After confirmation** - Warp exits the conversation and cancels the in-progress request. This confirmation step ensures you don't accidentally lose work when the agent is mid-task. diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx index dc46ff2f9..8c2460994 100644 --- a/src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx +++ b/src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx @@ -49,11 +49,11 @@ Terminal mode is the default when you open a new tab or pane. 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`. +* **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](#understanding-auto-detection) for configuration and override methods. @@ -118,7 +118,7 @@ In addition to local agent conversations, you can start **cloud agent conversati * Running agents autonomously in the cloud * 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. +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: @@ -167,7 +167,7 @@ You can control auto-detection separately for terminal mode and agent conversati There are multiple ways to override auto-detection: -* **Keyboard shortcut** - Press `⌘I` to switch between command and Agent Mode. +* **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: @@ -200,7 +200,7 @@ Type `/agent` or `/new` in terminal mode to enter the agent conversation view. T #### 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`. +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:** @@ -243,7 +243,7 @@ While you're in an agent conversation, you can access Warp's [slash commands](/a * 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 +* Press `Esc` to dismiss the menu **Key slash commands in Agent Mode:** @@ -251,7 +251,7 @@ While you're in an agent conversation, you can access Warp's [slash commands](/a * `/plan` or `/plan ` - 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` - 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. @@ -279,7 +279,7 @@ Forking lets you branch off from an existing conversation to explore a different 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). + * `⌘+↩` (`Ctrl+Shift+Enter` on Windows/Linux) - Fork in a new pane (keeps the original visible). **Fork and compact:** @@ -292,7 +292,7 @@ Use `/fork from` to choose exactly where in the conversation you want to branch 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). +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. @@ -325,7 +325,7 @@ You can also use the "toggle input mode" keyboard shortcut to override auto-dete 1. Go to **Settings** > **Agents** > **Warp Agent** > **Input**. 2. Toggle on **Autodetect terminal commands in agent input**. -Press `⌘I` (macOS) or `Ctrl+I` (Windows/Linux) to manually toggle between shell and Agent Mode at any time, overriding auto-detection. +Press `⌘+I` (macOS) or `Ctrl+I` (Windows/Linux) to manually toggle between shell and Agent Mode at any time, overriding auto-detection. :::note Auto-detection is enabled by default for new Warp users. @@ -339,15 +339,15 @@ In conversation view, press `?` to show/hide the full shortcuts panel. Here are ### 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` +* **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) +* **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 @@ -358,17 +358,17 @@ In conversation view, press `?` to show/hide the full shortcuts panel. Here are ### 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) +* **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** - `⌘+Shift++` (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` +* **Select and open in new pane** - `⌘+↩` (macOS) / `Ctrl+Shift+Enter` (Windows/Linux) +* **Dismiss menu** - `Esc` ### Customizing keybindings diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/voice.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/voice.mdx index c4abad4bc..cd5bff453 100644 --- a/src/content/docs/agent-platform/local-agents/interacting-with-agents/voice.mdx +++ b/src/content/docs/agent-platform/local-agents/interacting-with-agents/voice.mdx @@ -44,14 +44,14 @@ There are two ways to activate Voice: * Release the `Fn` key to stop recording and transcribe - * Press and hold the `ALT-RIGHT` key (configurable) to start recording + * Press and hold the right `Alt` key (configurable) to start recording * Speak your command or query while holding the key - * Release the `ALT-RIGHT` key to stop recording and transcribe + * Release the right `Alt` key to stop recording and transcribe - * Press and hold the `ALT-RIGHT` key (configurable) to start recording + * Press and hold the right `Alt` key (configurable) to start recording * Speak your command or query while holding the key - * Release the `ALT-RIGHT` key to stop recording and transcribe + * Release the right `Alt` key to stop recording and transcribe @@ -87,6 +87,6 @@ Voice features have anti-abuse limits in place to ensure fair usage. These limit 1. **Microphone not detected** If your microphone isn't being detected, first check your system permissions to ensure Warp has access. You should also verify that your microphone is properly connected to your system. If issues persist, try restarting Warp to reset the connection. 2. **Poor transcription quality** To improve transcription quality, try to minimize background noise in your environment. Position yourself closer to the microphone while speaking, and verify that your microphone input levels are properly adjusted in your system settings. For best results, speak clearly at a natural pace and use complete sentences to provide better context. When referring to specific file names or commands, enunciate them clearly. It's also recommended to review the transcription before sending to ensure accuracy. -3. **Feature not activating** If the Voice feature isn't activating, confirm that your hotkey settings are correctly configured in Warp. Check for any conflicting keyboard shortcuts that might interfere with Voice activation. Also ensure that you're running the latest version of Warp, as older versions can have compatibility issues. +3. **Feature not activating** If the Voice feature isn't activating, confirm that your hotkey settings are correctly configured in Warp. Check for any conflicting keyboard shortcuts that might interfere with Voice activation. Also ensure that you're running the latest version of Warp, as older versions can have compatibility issues. If you are on an Enterprise plan, your administrator may have disabled Voice functionality, or it may be pending approval. diff --git a/src/content/docs/changelog/2022.mdx b/src/content/docs/changelog/2022.mdx index 68e91a9c5..333a7f1ed 100644 --- a/src/content/docs/changelog/2022.mdx +++ b/src/content/docs/changelog/2022.mdx @@ -581,7 +581,7 @@ Submit bugs and feature requests on our [GitHub board!](https://github.com/warpd **New features** * Warm welcome! -* A.I. Command Search +* AI Command Search **Bug fixes** diff --git a/src/content/docs/changelog/2025.mdx b/src/content/docs/changelog/2025.mdx index b76dfe370..26dc3f21b 100644 --- a/src/content/docs/changelog/2025.mdx +++ b/src/content/docs/changelog/2025.mdx @@ -661,7 +661,7 @@ All of this comes with higher AI usage limits on our Pro and Turbo plans, plus n **Improvements** * Improved login item management to respect when users manually remove Warp from login items in System Preferences. -* The input editor now supports `CMD-SHIFT-UP/DOWN` on macOS or `CTRL-SHIFT-HOME/END` on Windows/ to move and select to the top/bottom of the text buffer. +* The input editor now supports `CMD-SHIFT-UP/DOWN` on macOS or `CTRL-SHIFT-HOME/END` on Windows/Linux to move and select to the top/bottom of the text buffer. * Removed 3-hour conversation timeout, allowing AI conversations to remain active indefinitely. * Show a small popup when users who are at AI limits have their quota reset. * Display a notification when AI request quota resets after hitting the limit in the previous billing cycle. diff --git a/src/content/docs/changelog/2026.mdx b/src/content/docs/changelog/2026.mdx index 2e84ee715..2f4d3a51b 100644 --- a/src/content/docs/changelog/2026.mdx +++ b/src/content/docs/changelog/2026.mdx @@ -477,13 +477,13 @@ Submit bugs and feature requests on our [GitHub board!](https://github.com/warpd * Agent handoff surfaces now accept empty prompts and support handing off in a single click. ([#11576](https://github.com/warpdotdev/warp/pull/11576)) * Added a setting to control whether orchestration messages are expanded or collapsed by default. ([#12219](https://github.com/warpdotdev/warp/pull/12219)) * Long-running command agent boxes can now be resized by dragging their top or left edge. ([#12236](https://github.com/warpdotdev/warp/pull/12236)) -* Fixed CLI subagent interactions being unexpectedly cancelled for Oz agents. ([#12384](https://github.com/warpdotdev/warp/pull/12384)) +* Fixed CLI subagent interactions being unexpectedly cancelled for agents. ([#12384](https://github.com/warpdotdev/warp/pull/12384)) ### 2026.06.03 (v0.2026.06.03.09.49) **New features** -* Added the installation path into de Windows App Paths Registry ([#10805](https://github.com/warpdotdev/warp/pull/10805)) — [@Cocodrulo](https://github.com/Cocodrulo) ✨ +* Added the installation path into the Windows App Paths Registry ([#10805](https://github.com/warpdotdev/warp/pull/10805)) — [@Cocodrulo](https://github.com/Cocodrulo) ✨ * Queue multiple follow-up prompts while the agent is working either by using the `/queue` command, prompt queueing mode (activated via a chip in the warping line), and/or by changing your default prompt submission mode to "Queue until response finishes" in settings. ([#12081](https://github.com/warpdotdev/warp/pull/12081)) **Improvements** @@ -605,7 +605,7 @@ Submit bugs and feature requests on our [GitHub board!](https://github.com/warpd **Oz updates** * Added search to the Oz Cloud API Keys settings page. ([#11307](https://github.com/warpdotdev/warp/pull/11307)) -* Fixed Oz cloud agent GitHub CLI authentication by writing refreshed credentials to gh's expected hosts.yml file. ([#11492](https://github.com/warpdotdev/warp/pull/11492)) +* Fixed cloud agent GitHub CLI authentication by writing refreshed credentials to gh's expected hosts.yml file. ([#11492](https://github.com/warpdotdev/warp/pull/11492)) * Added an execution profile permission for controlling whether agents can use run_agents. ([#11225](https://github.com/warpdotdev/warp/pull/11225)) ### 2026.05.20 (v0.2026.05.20.09.21) @@ -763,7 +763,7 @@ Submit bugs and feature requests on our [GitHub board!](https://github.com/warpd * Fixed pacman signing key validation before allowing Arch Linux auto-update ([#9706](https://github.com/warpdotdev/warp/pull/9706)) — @Naveen-Boddepalli ✨ * Tab titles for plugin-backed CLI agents (e.g. Claude Code via claude-code-warp) no longer keep showing stale permission-prompt text after a session completes. Thanks @lonexreb! ([#9671](https://github.com/warpdotdev/warp/pull/9671)) — @lonexreb ✨ * Fixed prompt branch picker clicks for branches checked out in linked worktrees. Thanks to @JasonLovesDoggo (#9264), @tkshsbcue (#9440), and @lonexreb (#9560) for earlier fixes and investigation. ([#9905](https://github.com/warpdotdev/warp/pull/9905)) — @kranthik10 ✨ -* Fix remote-server SSH wrapper failing to install the Oz agent on macOS remotes whose `bash -s` resolves to Apple bash 3.2 (the default), which surfaced as "Initialize: Response channel closed before receiving a reply" and a misplaced binary under `~/"/Users/.../"`. ([#10317](https://github.com/warpdotdev/warp/pull/10317)) — @lucasdoell ✨ +* Fix remote-server SSH wrapper failing to install the agent on macOS remotes whose `bash -s` resolves to Apple bash 3.2 (the default), which surfaced as "Initialize: Response channel closed before receiving a reply" and a misplaced binary under `~/"/Users/.../"`. ([#10317](https://github.com/warpdotdev/warp/pull/10317)) — @lucasdoell ✨ * Child agent initial prompts (from orchestrator) no longer appear in the agent input completion history. ([#10304](https://github.com/warpdotdev/warp/pull/10304)) * Fixed infinite SSE retry loop on stale agent runs ([#10383](https://github.com/warpdotdev/warp/pull/10383)) * Fixed Markdown table-of-contents anchor links in rendered notebooks. ([#10143](https://github.com/warpdotdev/warp/pull/10143)) — @haikomatt ✨ @@ -1354,7 +1354,7 @@ Oz is Warp's orchestration platform for cloud agents: launch parallel agents, au #### Warp Upgrades -* **Agent Modality** — two distinct modes: a clean terminal for commands, and a dedicated conversation view for multi-turn agent workflows with full controls (model select, voice, attachments). +* **Terminal and Agent modes** — two distinct modes: a clean terminal for commands, and a dedicated conversation view for multi-turn agent workflows with full controls (model select, voice, attachments). * **Cloud-Synced Conversations** — your agent conversations sync to the cloud and persist across devices. Share with teammates via link, view on the web, or continue locally. #### Agent Capabilities diff --git a/src/content/docs/code/code-editor/file-tree.mdx b/src/content/docs/code/code-editor/file-tree.mdx index 4929e82a1..eef200436 100644 --- a/src/content/docs/code/code-editor/file-tree.mdx +++ b/src/content/docs/code/code-editor/file-tree.mdx @@ -20,7 +20,7 @@ The file tree also works over SSH on macOS and Linux when Warp's [SSH extension] You can open the file tree from the tools panel on the left hand side: * **Tools panel**: Click the Tools sidebar button, then open the File Tree tab (first tab in the panel). -* Press `CMD + \` to open the left panel, then assign your own shortcut for File Tree (and Warp Drive) in **Settings** > **Keyboard shortcuts**. +* Press `Cmd+\` to open the left panel, then assign your own shortcut for File Tree (and Warp Drive) in **Settings** > **Keyboard shortcuts**. ![Opening the File Tree from the Tools panel sidebar in Warp.](../../../../assets/terminal/file-tree-project-explorer-tools-panel.png) @@ -36,11 +36,11 @@ Clicking on a file opens it directly in Warp’s [**native Code Editor**](/code/ Right-clicking any **file** opens a context menu with several useful options: -* **Open in new pane**: Open the file in a side-by-side pane. -* **Open in new tab**: Open the file in a new tab. -* **Attach as context**: Insert the file into an agent prompt so the Agent can analyze or reference it. -* **Copy path**: Copy the absolute file path. -* **Copy relative path**: Copy the path relative to your current working directory. +* **Open in new pane** - Open the file in a side-by-side pane. +* **Open in new tab** - Open the file in a new tab. +* **Attach as context** - Insert the file into an agent prompt so the Agent can analyze or reference it. +* **Copy path** - Copy the absolute file path. +* **Copy relative path** - Copy the path relative to your current working directory.
![Right-click context menu on a folder in the file tree.](../../../../assets/terminal/file-tree-context-menu.png) @@ -49,10 +49,10 @@ Right-clicking any **file** opens a context menu with several useful options: Right-clicking any **folder** opens a context menu with the following options: -* **Create new file**: Add a new file directly from the tree. +* **Create new file** - Add a new file directly from the tree. ![Creating a new file directly from a folder's right-click context menu in the file tree.](../../../../assets/terminal/file-tree-new-file.png) -* **Attach as context**: Insert the selected file into your agent prompt so the Agent can analyze or reference it. -* **Copy path**: Copy the absolute file path to your clipboard. -* **Copy relative path**: Copy the path relative to your current working directory. +* **Attach as context** - Insert the selected file into your agent prompt so the Agent can analyze or reference it. +* **Copy path** - Copy the absolute file path to your clipboard. +* **Copy relative path** - Copy the path relative to your current working directory. diff --git a/src/content/docs/code/code-editor/find-and-replace.mdx b/src/content/docs/code/code-editor/find-and-replace.mdx index 68c04ed4a..12e6555e3 100644 --- a/src/content/docs/code/code-editor/find-and-replace.mdx +++ b/src/content/docs/code/code-editor/find-and-replace.mdx @@ -12,10 +12,10 @@ Warp's code editor includes built-in find and replace with support for regex, ca ## Find -Press `CMD-F` on macOS or `CTRL-SHIFT-F` on Windows and Linux to open the find menu. As you type, all matches in the file are highlighted, and the match closest to your cursor is selected. +Press `Cmd+F` on macOS or `Ctrl+Shift+F` on Windows and Linux to open the find menu. As you type, all matches in the file are highlighted, and the match closest to your cursor is selected. -* Press `ENTER` or use the down arrow to jump to the next match -* Press `SHIFT-ENTER` or use the up arrow to go to the previous match +* Press `Enter` or use the down arrow to jump to the next match +* Press `Shift+Enter` or use the up arrow to go to the previous match * Click **Select All** to highlight all matches and close the menu You can toggle regex and case-sensitive search options directly in the query editor. diff --git a/src/content/docs/code/code-editor/index.mdx b/src/content/docs/code/code-editor/index.mdx index 2c8ed8833..78f39fae9 100644 --- a/src/content/docs/code/code-editor/index.mdx +++ b/src/content/docs/code/code-editor/index.mdx @@ -14,8 +14,8 @@ The editor is built for fast changes to agent-generated code: renaming a variabl **You can open files in the editor in several ways:** -1. **Click a file path** from the terminal output or an AI conversation and select "Open in Warp." -2. **Use the file menu in the Command Palette** (`CMD + O` on macOS, `CTRL + SHIFT + O` on Windows or Linux) when in a Git-tracked repo to search for and open files inside that repo. +1. **Click a file path** from the terminal output or an Agent conversation and select "Open in Warp." +2. **Use the file menu in the Command Palette** (`Cmd+O` on macOS, `Ctrl+Shift+O` on Windows or Linux) when in a Git-tracked repo to search for and open files inside that repo. 1. You can also access this via the magnifying glass icon in the pane coding toolbelt at the top left of any pane. @@ -25,7 +25,7 @@ The editor is built for fast changes to agent-generated code: renaming a variabl -**To save your changes to files**: use `CMD + S` on macOS or `CTRL + S` on Windows or Linux. +**To save your changes to files**: use `Cmd+S` on macOS or `Ctrl+S` on Windows or Linux. ### Tabbed file viewer diff --git a/src/content/docs/code/code-editor/language-server-protocol.mdx b/src/content/docs/code/code-editor/language-server-protocol.mdx index 952f38bd9..49b65b02f 100644 --- a/src/content/docs/code/code-editor/language-server-protocol.mdx +++ b/src/content/docs/code/code-editor/language-server-protocol.mdx @@ -60,11 +60,11 @@ Hover over a symbol to see its type signature, documentation, and other details ### Go to definition -Hold `CMD` (macOS) or `CTRL` (Windows/Linux) and click a symbol to jump to its definition. If the definition is in a different file, Warp opens it in the code editor. While you hold the modifier key, the symbol is underlined on hover to indicate it is navigable. +Hold `Cmd` (macOS) or `Ctrl` (Windows/Linux) and click a symbol to jump to its definition. If the definition is in a different file, Warp opens it in the code editor. While you hold the modifier key, the symbol is underlined on hover to indicate it is navigable. ### Find references -`CMD`-click (macOS) or `CTRL`-click (Windows/Linux) on a symbol that is already at its definition to see a **Find References** card listing all references across the workspace. Click any reference to navigate to it. +`Cmd`-click (macOS) or `Ctrl`-click (Windows/Linux) on a symbol that is already at its definition to see a **Find References** card listing all references across the workspace. Click any reference to navigate to it. ### Inline diagnostics @@ -72,7 +72,7 @@ Warp displays errors and warnings from the language server as dashed underlines ### Format on save -When you save a file (`CMD + S` / `CTRL + S`), Warp requests formatting from the language server before writing to disk. This applies the server's configured formatting rules (indentation, trailing whitespace, final newlines, etc.). If the server doesn't support formatting, the file is saved without formatting changes. +When you save a file (`Cmd+S` / `Ctrl+S`), Warp requests formatting from the language server before writing to disk. This applies the server's configured formatting rules (indentation, trailing whitespace, final newlines, etc.). If the server doesn't support formatting, the file is saved without formatting changes. ### Right-click context menu diff --git a/src/content/docs/code/code-review.mdx b/src/content/docs/code/code-review.mdx index eb9339ef4..8d530b015 100644 --- a/src/content/docs/code/code-review.mdx +++ b/src/content/docs/code/code-review.mdx @@ -17,7 +17,7 @@ When you are working locally in a Git repository with uncommitted changes, the * * Apply, edit, or revert changes in real time * See changes made outside of Warp or by Warp's Agents automatically reflected -Any uncommitted changes appear in the panel (or compare the changes on your branch against `main` or `master` ). Switching branches or saving files updates the panel instantly, so it always reflects the current state of your codebase. +Any uncommitted changes appear in the panel (or compare the changes on your branch against `main` or `master`). Switching branches or saving files updates the panel instantly, so it always reflects the current state of your codebase. @@ -81,7 +81,7 @@ During an Agent conversation, you can view all changed files in the toolbelt chi #### 4. Warp tab bar -In any Git-tracked repository, you can open the Code Review panel by clicking the `Code review` button in the top-right corner of Warp, next to your avatar. +In any Git-tracked repository, you can open the Code Review panel by clicking the **Code review** button in the top-right corner of Warp, next to your avatar. #### Viewing all edited files diff --git a/src/content/docs/code/overview.mdx b/src/content/docs/code/overview.mdx index 978d82c7f..5155b3899 100644 --- a/src/content/docs/code/overview.mdx +++ b/src/content/docs/code/overview.mdx @@ -29,9 +29,9 @@ Warp’s coding agent is designed to help you generate, edit, and manage code di ### How it works -* **Prompt-driven coding**: You write natural language prompts such as _“Add a retry mechanism to this API call”_ or _“Fix the failing unit test in auth.test.ts.”_ -* **Inline code diffs**: When the agent proposes changes, it shows them as diffs you can inspect, modify, or reject. -* **Agent steering**: You can refine prompts, interrupt and retry, or attach context (such as a file, diff, or selection) to guide the agent toward better results. +* **Prompt-driven coding** - You write natural language prompts such as _“Add a retry mechanism to this API call”_ or _“Fix the failing unit test in auth.test.ts.”_ +* **Inline code diffs** - When the agent proposes changes, it shows them as diffs you can inspect, modify, or reject. +* **Agent steering** - You can refine prompts, interrupt and retry, or attach context (such as a file, diff, or selection) to guide the agent toward better results. @@ -81,9 +81,9 @@ To begin a new project, select **Create a New Project** from the tab. You can st Select **Open Repository** to use your computer's file picker. If you choose a Git repository, Warp automatically changes into the directory and runs the `/init` setup command (a built-in "[slash command](/agent-platform/capabilities/slash-commands/)") if the repo has not already been initialized. Warp will detect the repository, index the codebase, and prepare it for coding. -* For non-Git folders, Warp simply changes into the directory without initialization. +* For non-Git folders, Warp changes into the directory without initialization. * If you have an existing project that is not yet initialized, you can run `/init` manually to bootstrap it with a version-controlled `AGENTS.md` file. -* This view also shows a list of your three most recently used repositories and AI conversations for quick access, as well as a list of recent directories (which behave like running `cd`). +* This view also shows a list of your three most recently used repositories and Agent conversations for quick access, as well as a list of recent directories (which behave like running `cd`). #### 3. Clone a repo diff --git a/src/content/docs/enterprise/enterprise-features/team-managed-keys-and-endpoints.mdx b/src/content/docs/enterprise/enterprise-features/team-managed-keys-and-endpoints.mdx index 860e87868..3c506a31a 100644 --- a/src/content/docs/enterprise/enterprise-features/team-managed-keys-and-endpoints.mdx +++ b/src/content/docs/enterprise/enterprise-features/team-managed-keys-and-endpoints.mdx @@ -97,7 +97,7 @@ By default, members can still choose Warp-managed models even when team provider ## Member experience -Members don't configure anything for team providers — they just select a model. Team-managed configuration syncs to each member's client automatically: +Members don't configure anything for team providers — they select a model. Team-managed configuration syncs to each member's client automatically: * **Custom endpoints** - Each enabled team endpoint model appears in the model picker as its own entry, showing the model's name (or alias) and the endpoint name. Members select it like any other model. * **First-party keys** - Members select the standard model for a provider (for example, a Claude, GPT, or Gemini model), and requests route through the team key automatically. If a member has added their own key for that provider, their own key takes precedence. diff --git a/src/content/docs/enterprise/getting-started/getting-started-developers.mdx b/src/content/docs/enterprise/getting-started/getting-started-developers.mdx index 87a65d2c9..8b42dc481 100644 --- a/src/content/docs/enterprise/getting-started/getting-started-developers.mdx +++ b/src/content/docs/enterprise/getting-started/getting-started-developers.mdx @@ -69,7 +69,7 @@ Do not attempt to launch Warp directly from your SSO provider's app portal (e.g. If you received an invite link from your team admin: 1. Click the invite link in your email or message. -2. From the signup page, log in using SSO if it's configured for your team, otherwise use one of the other sign in methods (Google, GitHub, or email). +2. From the signup page, log in using SSO if it's configured for your team, otherwise use one of the other sign-in methods (Google, GitHub, or email). 3. After authentication, you'll automatically join your team. ### Linking an existing account to SSO diff --git a/src/content/docs/enterprise/support-and-resources/troubleshooting-login.mdx b/src/content/docs/enterprise/support-and-resources/troubleshooting-login.mdx index e9a169d52..b9dc82260 100644 --- a/src/content/docs/enterprise/support-and-resources/troubleshooting-login.mdx +++ b/src/content/docs/enterprise/support-and-resources/troubleshooting-login.mdx @@ -48,7 +48,7 @@ If you see authentication errors or blank popups across browsers: 2. **Clear cookies and cache**, or try an incognito / private browser window. 3. Try the [Warp login page](https://app.warp.dev/login) again. -**Safari-specific:** If you see "Unable to access localStorage" errors, go to **Safari Preferences** > **Privacy** and uncheck **Block all cookies**. Firebase Auth requires cookies to track login state. +**Safari-specific:** If you see "Unable to access localStorage" errors, go to **Safari Preferences** > **Privacy** and deselect **Block all cookies**. Firebase Auth requires cookies to track login state. ## Proxy issues @@ -93,7 +93,7 @@ If the browser doesn't open automatically from Warp when you click "Sign up" or 4. Paste the token into Warp. :::note -On Linux and Windows, the default paste shortcut is `CTRL+SHIFT+V`. +On Linux and Windows, the default paste shortcut is `Ctrl+Shift+V`. ::: ## Getting help diff --git a/src/content/docs/getting-started/quickstart/installation-and-setup.mdx b/src/content/docs/getting-started/quickstart/installation-and-setup.mdx index 2fe147395..2df23fda9 100644 --- a/src/content/docs/getting-started/quickstart/installation-and-setup.mdx +++ b/src/content/docs/getting-started/quickstart/installation-and-setup.mdx @@ -146,7 +146,7 @@ import VideoEmbed from '@components/VideoEmbed.astro'; **AppImage** - We also provide an [AppImage](https://appimage.org), a single-file executable version of Warp. Installing Warp via a package manager is recommended, as it will ensure your system has all necessary dependencies installed. + Warp also provides an [AppImage](https://appimage.org), a single-file executable version of Warp. Installing Warp via a package manager is recommended, as it will ensure your system has all necessary dependencies installed. You can download the Warp AppImage with the following commands: @@ -203,7 +203,7 @@ If you sign up using Google or GitHub, Warp only gets access to the associated e ### Use Warp offline -You will only need an active internet connection when you open the Warp app for the first time. Once opened, [Warp is able to run with no internet connection](/support-and-community/troubleshooting-and-support/using-warp-offline/), although certain features that require an internet connection like AI and real-time collaboration features will be unavailable. +You will only need an active internet connection when you open the Warp app for the first time. Once opened, [Warp can run with no internet connection](/support-and-community/troubleshooting-and-support/using-warp-offline/), although certain features that require an internet connection like AI and real-time collaboration features will be unavailable. ### Import your settings diff --git a/src/content/docs/getting-started/supported-shells.mdx b/src/content/docs/getting-started/supported-shells.mdx index 86e1a248e..e3eee5723 100644 --- a/src/content/docs/getting-started/supported-shells.mdx +++ b/src/content/docs/getting-started/supported-shells.mdx @@ -23,7 +23,7 @@ If you run into issues configuring your RC files (`~/.bashrc`, `~/.zshrc`, `conf ### Changing what shell Warp uses -To change the default shell, we recommend you choose a shell in Warp by going to **Settings** > **Features** and scrolling to the **Session** section, then select **Startup shell for new sessions**. +To change the default shell, choose a shell in Warp by going to **Settings** > **Features** and scrolling to the **Session** section, then select **Startup shell for new sessions**. :::note The changes to your shell will only take effect when you start a new session. @@ -113,7 +113,7 @@ By default, macOS ships with [zsh](https://zsh.sourceforge.io/Doc/Release/zsh_to While bash and zsh come pre-installed on macOS systems, fish shell does not. So before using fish with Warp, you will need to install it. Install fish 3.6 or above using one of the methods listed below: -1. With Homebrew: If you already have homebrew installed, you can simply type `brew install fish`, and follow the instructions. +1. With Homebrew: If you already have Homebrew installed, you can type `brew install fish`, and follow the instructions. 2. Download the installer from the [fish shell website](https://fishshell.com/). #### 2. Switch to fish as the default shell @@ -142,7 +142,7 @@ You can identify where fish is installed by running `which fish`. While bash and zsh come pre-installed on macOS systems, PowerShell does not. So before using PowerShell with Warp, you will need to install it. Install PowerShell 7.0 or above using one of the methods listed below: -1. With Homebrew: If you already have homebrew installed, you can simply type `brew install powershell/tap/powershell`, and follow the instructions. +1. With Homebrew: If you already have Homebrew installed, you can type `brew install powershell/tap/powershell`, and follow the instructions. 2. Download from the [official Microsoft website](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell). #### 2. Switch to pwsh as the default shell diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index d505a68a6..55518ee78 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -23,10 +23,10 @@ Warp is where you work — a fast, modern terminal built for coding with agents. **Key capabilities:** -* [**Terminal and Agent modes**](/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes/): Switch between a clean terminal for commands and a dedicated conversation view for multi-turn agent workflows. -* [**Modern terminal UX**](/terminal/editor/): Cursor movement, block-based navigation, multi-line editing, syntax highlighting, and rich completions. Built with Rust for high performance. -* [**Code editor**](/code/overview/): File tree, code editor with LSP support, and interactive code review experience. -* [**Third-party CLI agents**](/agent-platform/cli-agents/overview/): Run third-party CLI agents like Claude Code, Codex, and OpenCode with Warp's agent toolbelt — rich input, code review, notifications, and more. +* [**Terminal and Agent modes**](/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes/) - Switch between a clean terminal for commands and a dedicated conversation view for multi-turn agent workflows. +* [**Modern terminal UX**](/terminal/editor/) - Cursor movement, block-based navigation, multi-line editing, syntax highlighting, and rich completions. Built with Rust for high performance. +* [**Code editor**](/code/overview/) - File tree, code editor with LSP support, and interactive code review experience. +* [**Third-party CLI agents**](/agent-platform/cli-agents/overview/) - Run third-party CLI agents like Claude Code, Codex, and OpenCode with Warp's agent toolbelt — rich input, code review, notifications, and more. @@ -55,10 +55,10 @@ Local agents keep you in control. You can review changes, steer the agent mid-ta Cloud agents run in the background on Warp's infrastructure (or your own) for automation at scale. -* **Triggers**: React to events from Slack, Linear, GitHub, or custom webhooks -* **Schedules**: Run recurring tasks like dependency updates or dead code removal -* **Parallelism**: Run many agents concurrently across repos or tasks -* **Observability**: Every run is tracked, auditable, and shareable with your team +* **Triggers** - React to events from Slack, Linear, GitHub, or custom webhooks +* **Schedules** - Run recurring tasks like dependency updates or dead code removal +* **Parallelism** - Run many agents concurrently across repos or tasks +* **Observability** - Every run is tracked, auditable, and shareable with your team Cloud agents are ideal for work that doesn't need your immediate attention, like PR reviews, issue triage, routine maintenance, and integration-driven workflows. @@ -70,10 +70,10 @@ Cloud agents are ideal for work that doesn't need your immediate attention, like Warp and Oz provide a unified experience across local and cloud development: -* **Same agent, anywhere**: Whether you're working interactively in Warp or running agents in the cloud, you're using the same underlying agent capabilities. -* **Seamless handoff**: Start a task in the cloud and take over locally in Warp when you want hands-on control, without losing progress or context. -* **Shared context**: [Warp Drive](/knowledge-and-collaboration/warp-drive/), [Rules](/agent-platform/capabilities/rules/), and [MCP servers](/agent-platform/capabilities/mcp/) work across both local and cloud agents, so your team's knowledge and tools are always available. -* **Team collaboration**: Share agent sessions, review agents' actions, and steer running tasks, regardless of who started them. +* **Same agent, anywhere** - Whether you're working interactively in Warp or running agents in the cloud, you're using the same underlying agent capabilities. +* **Seamless handoff** - Start a task in the cloud and take over locally in Warp when you want hands-on control, without losing progress or context. +* **Shared context** - [Warp Drive](/knowledge-and-collaboration/warp-drive/), [Rules](/agent-platform/capabilities/rules/), and [MCP servers](/agent-platform/capabilities/mcp/) work across both local and cloud agents, so your team's knowledge and tools are always available. +* **Team collaboration** - Share agent sessions, review agents' actions, and steer running tasks, regardless of who started them. --- @@ -103,7 +103,7 @@ Warp's AI features can be globally disabled in **Settings** > **Agents** > **War ## Next steps -* [**Quickstart**](/quickstart/): Get Warp installed and start coding -* [**Warp Agents overview**](/agent-platform/local-agents/overview/): Explore all AI features available in Warp -* [**Cloud Agents overview**](/platform/): Set up background automation -* [**Oz Platform**](/platform/overview/): Learn about the CLI, API, SDK, and infrastructure +* [**Quickstart**](/quickstart/) - Get Warp installed and start coding +* [**Warp Agents overview**](/agent-platform/local-agents/overview/) - Explore all AI features available in Warp +* [**Cloud Agents overview**](/platform/) - Set up background automation +* [**Oz Platform**](/platform/overview/) - Learn about the CLI, API, SDK, and infrastructure diff --git a/src/content/docs/knowledge-and-collaboration/teams.mdx b/src/content/docs/knowledge-and-collaboration/teams.mdx index 320e8fd2a..836eaad06 100644 --- a/src/content/docs/knowledge-and-collaboration/teams.mdx +++ b/src/content/docs/knowledge-and-collaboration/teams.mdx @@ -21,10 +21,10 @@ Currently, each Warp user can only be an admin or member of one team at a time. You can create a new team in the following ways: -* Warp Drive, + Create a team +* In Warp Drive, click **+ Create a team**. * **Settings** > **Teams** -Before you can invite team members, you will need to give your team a meaningful name. We suggest using a name to represent your organization, company, or project. +Before you can invite team members, give your team a meaningful name that represents your organization, company, or project. :::note You can rename the team by going to **Settings** > **Teams** and clicking on the team name, entering the new name, and pressing `Enter` to accept. @@ -49,11 +49,11 @@ For more details on how team member billing works, please see our [billing FAQs]
Teams settings panel.
-When you share this link with your teammates directly (we suggest using a secure channel like Slack or email), they will be able to join your team in Warp. +When you share this link with your teammates directly (using a secure channel like Slack or email is recommended), they will be able to join your team in Warp. ## Restricting team invites by domain -Sometimes you may want to control your team so that people can only join if they also authenticate with a specific email domain, such as your company’s email domain. +You can control your team so that people can only join if they also authenticate with a specific email domain, such as your company’s email domain. Toggle on **Restrict by domain** to set an explicit allowlist. @@ -61,7 +61,7 @@ If you share an invite link with somebody who’s using Warp with a domain that ## Joining a team -If you have received an invite link, you can use that link to sign up or log in and join your team in Warp. If your team is using domain restriction, you will need to authenticate you have access to a specific domain before you can join your team. +If you have received an invite link, you can use that link to sign up or log in and join your team in Warp. If your team is using domain restriction, you will need to authenticate that you have access to a specific domain before you can join your team. ## Leaving and deleting teams diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx index 260ec7424..d36141096 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx @@ -18,8 +18,8 @@ Environment variables in Warp are similar to .env files, except you can: You can create new environment variables through: -* [Warp Drive](/knowledge-and-collaboration/warp-drive/), + → Environment variable -* [Command Palette](/terminal/command-palette/), create new team or personal environment variables +* From [Warp Drive](/knowledge-and-collaboration/warp-drive/), click **+** and select **Environment variable**. +* From the [Command Palette](/terminal/command-palette/), create a new team or personal environment variable. Any of these entry points will open the environment variables editor where you can name and describe your environment variables. @@ -41,7 +41,7 @@ After you save the environment variable, you can click it to load it into your t When you use static variables, Warp stores them securely in Warp Drive.\ \ -Note: Static variables should not be used to replace a secret manager. Please use dynamic variables for any sensitive information. +Note: Don't use static variables to replace a secret manager. Use dynamic variables for any sensitive information. ### Dynamic variables @@ -87,7 +87,7 @@ Selecting a secret name never stores the actual secret. Warp uses your selection Reference the documentation for your external secret manager. Then, write a custom command to retrieve secrets. :::note -Your custom command should return the exact string you want loaded into your environment. Please make sure that you are selecting the exact field you want loaded as many secret manager CLIs provide additional formatting by default. +Your custom command should return the exact string you want loaded into your environment. Please make sure that you are selecting the exact field you want loaded, as many secret manager CLIs provide additional formatting by default. ::: For example, you can write a command using the [Hashicorp Vault CLI](https://developer.hashicorp.com/vault/docs/commands) to retrieve and load the password field for the staging server. When using secret commands, Warp stores the command but never the actual secrets. The secrets are referenced and loaded into a terminal session at runtime. @@ -102,7 +102,7 @@ For example, you can write a command using the [Hashicorp Vault CLI](https://dev There are three ways to invoke your environment variables and load them into a terminal session: -1. [Click to load into a current section](/knowledge-and-collaboration/warp-drive/environment-variables/#click-to-load-into-a-current-session) +1. [Click to load into a current session](/knowledge-and-collaboration/warp-drive/environment-variables/#click-to-load-into-a-current-session) 2. [Click to load into a subshell](/knowledge-and-collaboration/warp-drive/environment-variables/#click-to-load-into-a-subshell) 3. [Select to load in with a workflow](/knowledge-and-collaboration/warp-drive/environment-variables/#select-to-load-with-a-workflow) @@ -110,7 +110,7 @@ There are three ways to invoke your environment variables and load them into a t First, click your environment variable from Warp Drive or the Command Palette. -Then, review the confirmation block. If your environment variables are correct, hit enter to load them into your session. +Then, review the confirmation block. If your environment variables are correct, press `Enter` to load them into your session. ![Confirmation block prompting to load environment variables into the current session.](../../../../assets/terminal/env-var-load-to-input-1.png) @@ -140,4 +140,4 @@ These environment variables will now be present for the remainder of your sessio ### Import and export environment variables in Warp Drive -Please see our [Warp Drive Import and Export](/knowledge-and-collaboration/warp-drive/#import-and-export) instructions. +See the [Warp Drive Import and Export](/knowledge-and-collaboration/warp-drive/#import-and-export) instructions. diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx index f46a98bab..93b0b2b2f 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx @@ -20,13 +20,13 @@ All objects stored in Warp Drive sync immediately as they’re updated, so you a - Warp Drive is accessible from the status bar in Warp, from the [Warp Drive web experience](/knowledge-and-collaboration/warp-drive/web/), or you can toggle the Warp Drive side panel with `CMD-\`. + Warp Drive is accessible from the status bar in Warp, from the [Warp Drive web experience](/knowledge-and-collaboration/warp-drive/web/), or you can toggle the Warp Drive side panel with `Cmd+\`. - Warp Drive is accessible from the status bar in Warp, from the [Warp Drive web experience](/knowledge-and-collaboration/warp-drive/web/), or you can toggle the Warp Drive side panel with `CTRL-SHIFT-\`. + Warp Drive is accessible from the status bar in Warp, from the [Warp Drive web experience](/knowledge-and-collaboration/warp-drive/web/), or you can toggle the Warp Drive side panel with `Ctrl+Shift+\`. - Warp Drive is accessible from the status bar in Warp, from the [Warp Drive web experience](/knowledge-and-collaboration/warp-drive/web/), or you can toggle the Warp Drive side panel with `CTRL-SHIFT-\`. + Warp Drive is accessible from the status bar in Warp, from the [Warp Drive web experience](/knowledge-and-collaboration/warp-drive/web/), or you can toggle the Warp Drive side panel with `Ctrl+Shift+\`. @@ -69,30 +69,30 @@ You can take these keyboard actions within Warp Drive: - * Press `UP`/`DOWN` or `j`/`k` to navigate to the object you want. + * Press `↑`/`↓` or `j`/`k` to navigate to the object you want. * Press `Enter` to 1) execute an object, 2) open/collapse a workspace or folder, or 3) open the trash. - * Press `CMD-ENTER` to open an object’s context menu. - * Press `CMD-SHIFT-(` and `CMD-SHIFT-)` to switch focus between the terminal and Warp Drive. - * Press `LEFT-ARROW` to collapse a workspace or folder - * Press `RIGHT-ARROW` to open a workspace or folder + * Press `Cmd+Enter` to open an object’s context menu. + * Press `Cmd+Shift+(` and `Cmd+Shift+)` to switch focus between the terminal and Warp Drive. + * Press `←` to collapse a workspace or folder + * Press `→` to open a workspace or folder * Press `Esc` to return to Warp Drive from your trash. - * Press `UP`/`DOWN` or `j`/`k` to navigate to the object you want. + * Press `↑`/`↓` or `j`/`k` to navigate to the object you want. * Press `Enter` to 1) execute an object, 2) open/collapse a workspace or folder, or 3) open the trash. - * Press `CTRL-ENTER` to open an object’s context menu. - * Press `CTRL-SHIFT-(` and `CTRL-SHIFT-)` to switch focus between the terminal and Warp Drive. - * Press `LEFT-ARROW` to collapse a workspace or folder - * Press `RIGHT-ARROW` to open a workspace or folder + * Press `Ctrl+Enter` to open an object’s context menu. + * Press `Ctrl+Shift+(` and `Ctrl+Shift+)` to switch focus between the terminal and Warp Drive. + * Press `←` to collapse a workspace or folder + * Press `→` to open a workspace or folder * Press `Esc` to return to Warp Drive from your trash. - * Press `UP`/`DOWN` or `j`/`k` to navigate to the object you want. + * Press `↑`/`↓` or `j`/`k` to navigate to the object you want. * Press `Enter` to 1) execute an object, 2) open/collapse a workspace or folder, or 3) open the trash. - * Press `CTRL-ENTER` to open an object’s context menu. - * Press `CTRL-SHIFT-(` and `CTRL-SHIFT-)` to switch focus between the terminal and Warp Drive. - * Press `LEFT-ARROW` to collapse a workspace or folder - * Press `RIGHT-ARROW` to open a workspace or folder + * Press `Ctrl+Enter` to open an object’s context menu. + * Press `Ctrl+Shift+(` and `Ctrl+Shift+)` to switch focus between the terminal and Warp Drive. + * Press `←` to collapse a workspace or folder + * Press `→` to open a workspace or folder * Press `Esc` to return to Warp Drive from your trash. @@ -117,7 +117,7 @@ Every object in Warp Drive can be exported to or imported from a file. When impo ### Importing files into Warp Drive -To import a local file or directory, `RIGHT-CLICK` on a folder or click **+** on a workspace and choose "Import." If importing a directory, supported files in the directory and its sub-directories will be imported into a matching folder structure. +To import a local file or directory, right-click a folder or click **+** on a workspace and choose "Import." If importing a directory, supported files in the directory and its sub-directories will be imported into a matching folder structure.
![Import modal](../../../../assets/terminal/notebook-import-modal.png) @@ -126,7 +126,7 @@ To import a local file or directory, `RIGHT-CLICK` on a folder or click **+** on ### Exporting files from Warp Drive -To export a single Warp Drive object, `RIGHT-CLICK` on an object and choose "Export" from the menu, then select a directory for export. To export all Warp Drive objects, open the [Command Palette](/terminal/command-palette/#how-to-access-it), search for and select "Export all Warp Drive objects", then select a directory for export. +To export a single Warp Drive object, right-click an object and choose "Export" from the menu, then select a directory for export. To export all Warp Drive objects, open the [Command Palette](/terminal/command-palette/#how-to-access-it), search for and select "Export all Warp Drive objects", then select a directory for export. ## Sharing your drive objects @@ -190,4 +190,4 @@ Owners and their teammates always have full access. When sharing an object, you ## Troubleshooting Warp Drive * If you were previously using Warp on your own and were later invited to join a team, you may need to exit, update, and restart the Warp app to gain access to your team’s shared drive and commands -* Navigating to Settings > Teams in Warp should also force a metadata update for you, which will ensure you have access to the latest versions of Workflows in your team's drive +* Navigating to **Settings** > **Teams** in Warp should also force a metadata update for you, which will ensure you have access to the latest versions of Workflows in your team's drive diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx index 8738e2d26..2f34b19cb 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx @@ -19,15 +19,15 @@ You can create a new notebook from various entry points in Warp - * From Warp Drive, + > New notebook + * From Warp Drive, click **+** > **New notebook** * From the [Command Palette](/terminal/command-palette/), create a new team or personal notebook. - * From Warp Drive, + > New notebook + * From Warp Drive, click **+** > **New notebook** * From the [Command Palette](/terminal/command-palette/), create a new team or personal notebook. - * From Warp Drive, + > New notebook + * From Warp Drive, click **+** > **New notebook** * From the [Command Palette](/terminal/command-palette/), create a new team or personal notebook. @@ -38,7 +38,7 @@ Any of these entry points will open the notebook editor where you can: * Start adding text and code elements. :::note -The notebook will not be saved until either title or body text is added. +Warp does not save the notebook until you add a title or body text. :::
@@ -96,15 +96,15 @@ Developers can execute shell command blocks by: * Using the insert button at the bottom of the block - * Pressing `CMD-ENTER` while the block is selected (a blue highlight will appear) + * Pressing `Cmd+Enter` while the block is selected (a blue highlight will appear) * Using the insert button at the bottom of the block - * Pressing `CTRL-ENTER` while the block is selected (a blue highlight will appear) + * Pressing `Ctrl+Enter` while the block is selected (a blue highlight will appear) * Using the insert button at the bottom of the block - * Pressing `CTRL-ENTER` while the block is selected (a blue highlight will appear) + * Pressing `Ctrl+Enter` while the block is selected (a blue highlight will appear) @@ -131,21 +131,21 @@ Command Blocks also support keyboard navigation. There are two ways to enter the * Clicking on a shell block. - * Pressing `CMD-UP` or `CMD-DOWN.` + * Pressing `Cmd+Up` or `Cmd+Down`. - Once a command block is selected, press `CMD-ENTER` to insert it into the terminal input. You can also use `UP, DOWN, CMD-UP`, and `CMD-DOWN` to navigate between command blocks. While the Notebook is focused, press `CMD-L` to switch focus back to the terminal without inserting a command. + Once a command block is selected, press `Cmd+Enter` to insert it into the terminal input. You can also use `Up`, `Down`, `Cmd+Up`, and `Cmd+Down` to navigate between command blocks. While the Notebook is focused, press `Cmd+L` to switch focus back to the terminal without inserting a command. * Clicking on a shell block. - * Pressing `CTRL-UP` or `CTRL-DOWN.` + * Pressing `Ctrl+Up` or `Ctrl+Down`. - Once a command block is selected, press `CTRL-ENTER` to insert it into the terminal input. You can also use `UP, DOWN, CTRL-UP,` and `CTRL-DOWN` to navigate between command blocks. While the Notebook is focused, press `CTRL-L` to switch focus back to the terminal without inserting a command. + Once a command block is selected, press `Ctrl+Enter` to insert it into the terminal input. You can also use `Up`, `Down`, `Ctrl+Up`, and `Ctrl+Down` to navigate between command blocks. While the Notebook is focused, press `Ctrl+L` to switch focus back to the terminal without inserting a command. * Clicking on a shell block. - * Pressing `CTRL-UP` or `CTRL-DOWN.` + * Pressing `Ctrl+Up` or `Ctrl+Down`. - Once a command block is selected, press `CTRL-ENTER` to insert it into the terminal input. You can also use `UP, DOWN, CTRL-UP,` and `CTRL-DOWN` to navigate between command blocks. While the Notebook is focused, press `CTRL-L` to switch focus back to the terminal without inserting a command. + Once a command block is selected, press `Ctrl+Enter` to insert it into the terminal input. You can also use `Up`, `Down`, `Ctrl+Up`, and `Ctrl+Down` to navigate between command blocks. While the Notebook is focused, press `Ctrl+L` to switch focus back to the terminal without inserting a command. @@ -173,4 +173,4 @@ Only one editor is allowed at a given time. Opening the notebook while there is ### Import and export notebooks in Warp Drive -Please see our [Warp Drive Import and Export](/knowledge-and-collaboration/warp-drive/#import-and-export) instructions. +See the [Warp Drive Import and Export](/knowledge-and-collaboration/warp-drive/#import-and-export) instructions. diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx index bc4096fc4..7c60241e8 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx @@ -50,14 +50,14 @@ In the prompt editor, you can add arguments manually with "New argument" or by t There are some rules for creating valid arguments: -* Argument names can only include characters `A-Za-z0-9`, hyphens `-` and underscores `_` -* The first character of an argument cannot be a number +* Argument names can only include characters `A-Za-z0-9`, hyphens `-`, and underscores `_`. +* The first character of an argument cannot be a number. Arguments can be one of two types: text or enum. By default, all new arguments are text type. #### Enum type arguments -Enums allow you to specify expected inputs to a prompt argument. When you insert a prompt with enums into the input editor, you will be prompted with suggestions for filling in the argument. You can open the suggestions menu by pressing `SHIFT-TAB` while selecting an argument. +Enums allow you to specify expected inputs to a prompt argument. When you insert a prompt with enums into the input editor, you will be prompted with suggestions for filling in the argument. You can open the suggestions menu by pressing `Shift+Tab` while selecting an argument. For detailed information about creating and using enum type arguments, please see the [Enum type arguments section in Workflows documentation](/knowledge-and-collaboration/warp-drive/workflows/#enum-type-arguments). @@ -65,7 +65,7 @@ For detailed information about creating and using enum type arguments, please se If the prompt is shared with a team, all team members will have access to edit it and updates will sync immediately for all members of the team. -If a prompt in the Warp Drive has been edited by another team member or a user on another device while you are attempting to edit the same prompt, you will not be able to save changes; you will need to check out the latest version and try again. +If a prompt in the Warp Drive has been edited by another team member or a user on another device while you are attempting to edit the same prompt, you can't save changes; check out the latest version and try again. ## How to execute prompts @@ -73,7 +73,7 @@ You can execute a prompt in several ways: * From Warp Drive, click the prompt * From the [Command Palette](/terminal/command-palette/) or [Command Search](/terminal/entry/command-search/), search for a prompt by name or type "prompts:" to see all available prompts and your prompt history -* When a prompt is selected, you can use `SHIFT-TAB` to cycle through the arguments. +* When a prompt is selected, you can use `Shift+Tab` to cycle through the arguments.
![Command Palette interface showing a search for Prompts with results displayed](../../../../assets/terminal/prompts-command-palette.png) @@ -91,4 +91,4 @@ You can make any adjustments you need to the arguments before running the prompt ### Import and export prompts in Warp Drive -Please see our [Warp Drive Import and Export](/knowledge-and-collaboration/warp-drive/#import-and-export) instructions. +See the [Warp Drive Import and Export](/knowledge-and-collaboration/warp-drive/#import-and-export) instructions. diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/web.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/web.mdx index ff5aecc2b..a35c5cc4f 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/web.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/web.mdx @@ -33,26 +33,26 @@ You can edit and view web-based objects and sessions as normal. The one exceptio If the Warp app is installed, links will open on the desktop by default. You can manage whether Warp links open in Warp's desktop app or the browser in multiple ways: :::note -The desktop option is only presented if Warp's web service is able to detect the Warp app installed locally. Warp desktop opens localhost port 9277 to accomplish this detection. This is done in a separate process that does not have access to your terminal contents.\ +The desktop option is only presented if Warp's web service can detect the Warp app installed locally. Warp desktop opens localhost port 9277 to accomplish this detection. This is done in a separate process that does not have access to your terminal contents.\ \ -If you would like to use Warp locally and do not have it installed, please visit our [installation guide.](/getting-started/quickstart/installation-and-setup/) +If you would like to use Warp locally and do not have it installed, please visit the [installation guide](/getting-started/quickstart/installation-and-setup/). ::: 1. The first time you follow a link, if Warp is not installed, you will be prompted to download it. You can dismiss the popup to stay on the web. ![Popup prompting to download Warp Desktop when viewing a Drive object on the web](../../../../assets/terminal/wd-popup-message.png) -2. This preference can be changed at any point in **Settings** > **Features** > **General** > **Open links in desktop app** Note that this setting is only available while on the web-based version of Warp. +2. You can change this preference at any point in **Settings** > **Features** > **General** > **Open links in desktop app**. This setting is only available while on the web-based version of Warp.
![Setting managing how to open links](../../../../assets/terminal/wd-open-links-preference.png)
Setting managing how to open links.
3. You can always switch between web and desktop views on a case-by-case basis. - 1. To switch from a web-view to Desktop for a given object, open the _overflow menu > Open link on Desktop._ + 1. To switch from a web-view to Desktop for a given object, open the **overflow menu** > **Open link on Desktop**. ![Overflow menu on a web-based Drive object with the Open on Desktop option highlighted](../../../../assets/terminal/wd-switch-viewer.png) - 2. To stay on the web for a given object despite a global Desktop preference, follow the _View on the web_ option that is part of the redirect screen to Desktop. + 2. To stay on the web for a given object despite a global Desktop preference, follow the **View on the web** option that is part of the redirect screen to Desktop. ![Redirect screen with Open Warp and View on the web options](../../../../assets/terminal/wd-view-on-web.png) diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx index 4e85db2f3..0a3669bbc 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx @@ -19,10 +19,10 @@ A workflow is a parameterized command you can name and save in Warp with descrip You can create a new workflow from various entry points in Warp: -* From Warp Drive, + > New workflow -* Using Block Actions, Save as Workflow -* From agent results, Save as Workflow -* From the [Command Palette](/terminal/command-palette/), Create a New Personal Workflow +* From Warp Drive, click **+** > **New workflow** +* From Block Actions, select **Save as Workflow** +* From agent results, select **Save as Workflow** +* From the [Command Palette](/terminal/command-palette/), select **Create a New Personal Workflow** Any of these entry points will open the workflow editor where you can: @@ -44,14 +44,14 @@ In the workflow editor, you can add arguments manually with "New argument" or by There are some rules for creating valid arguments: -* Argument names can only include characters `A-Za-z0-9`, hyphens `-` and underscores `_` -* The first character of an argument cannot be a number +* Argument names can only include characters `A-Za-z0-9`, hyphens `-`, and underscores `_`. +* The first character of an argument cannot be a number. Arguments can be one of two types: text or enum. By default, all new arguments are text type. #### Enum type arguments -Enums allow you to specify expected inputs to a workflow argument. When you insert a workflow with enums into the input editor, you will be prompted with suggestions for filling in the argument. You can open the suggestions menu by pressing `SHIFT-TAB` while selecting an argument. +Enums allow you to specify expected inputs to a workflow argument. When you insert a workflow with enums into the input editor, you will be prompted with suggestions for filling in the argument. You can open the suggestions menu by pressing `Shift+Tab` while selecting an argument. @@ -85,7 +85,7 @@ Once a workflow has been created, you can edit it at any time, as long as you ha Workflows also have the option to use an [agent](/agent-platform/local-agents/overview/) to automatically generate a title, descriptions, or parameters. -* Create or edit a Workflow, in the edit view you should see the option to AutoFill. +* When you create or edit a Workflow, the edit view shows the option to **AutoFill**. * Warp will fill in the fields based on the Workflow you're creating. @@ -94,25 +94,25 @@ Workflows also have the option to use an [agent](/agent-platform/local-agents/ov If the workflow is shared with a team, all team members will have access to edit the workflow and updates will sync immediately for all members of the team. -If a workflow in the Warp Drive has been edited by another team member or a user on another device while you are attempting to edit the same workflow, you will not be able to save changes; you will need to check out the latest version and try again. +If a workflow in the Warp Drive has been edited by another team member or a user on another device while you are attempting to edit the same workflow, you can't save changes; check out the latest version and try again. ## How to execute workflows You can execute a workflow in several ways: * From Warp Drive, click the workflow -* From the [Command Palette](/terminal/command-palette/), search for a workflow you’d like to execute, click or select, and enter +* From the [Command Palette](/terminal/command-palette/), search for a workflow you’d like to execute, click or select, and enter. * From [Command Search](/terminal/entry/command-search/), search for a workflow you'd like to execute, click or select, and enter. -* When a workflow is selected, you can use `SHIFT-TAB` to cycle through the arguments. +* When a workflow is selected, you can use `Shift+Tab` to cycle through the arguments. :::note When you create two or more arguments with the same name, Warp automatically selects and puts multiple cursors over the arguments in the input editor so they are synced.\ \ -Also, tailor your Command Search experience by toggling off "Show Global Workflows" in **Settings** > **Features**. When disabled, your search will exclusively encompass YAML and Warp Drive Workflows. +Also, tailor your Command Search experience by toggling off "Show Global Workflows" in **Settings** > **Features**. When disabled, your search will only include YAML and Warp Drive Workflows. :::
-![Search for any workflow in the Command Palette with CMD + P](../../../../assets/terminal/search-workflow-command-palette.png) +![Search for any workflow in the Command Palette with Cmd+P](../../../../assets/terminal/search-workflow-command-palette.png)
Searching for Workflows in the Command Palette.
@@ -135,4 +135,4 @@ If needed, you can continue to access your `.yaml` file workflows using [Command ### Import and export workflows in Warp Drive -Please see our [Warp Drive Import and Export](/knowledge-and-collaboration/warp-drive/#import-and-export) instructions. +See the [Warp Drive Import and Export](/knowledge-and-collaboration/warp-drive/#import-and-export) instructions. diff --git a/src/content/docs/platform/environments.mdx b/src/content/docs/platform/environments.mdx index 4a1a84c74..3546a58d2 100644 --- a/src/content/docs/platform/environments.mdx +++ b/src/content/docs/platform/environments.mdx @@ -68,7 +68,7 @@ Components in the execution flow: 6. **Outputs** – The run produces PRs, messages, reports, or transcripts :::note -**Local agent** runs (using `oz agent run`) don't require an environment. These runs use your current machine's setup. Environments are required for **automated platform** runs like cloud agents and integrations +**Local agent** runs (using `oz agent run`) don't require an environment. These runs use your current machine's setup. Environments are required for **automated platform** runs like cloud agents and integrations. ::: ### Hosts and environments diff --git a/src/content/docs/platform/integrations/linear.mdx b/src/content/docs/platform/integrations/linear.mdx index 791ee47f4..46ca8376e 100644 --- a/src/content/docs/platform/integrations/linear.mdx +++ b/src/content/docs/platform/integrations/linear.mdx @@ -94,7 +94,7 @@ You can create an environment via: * The CLI * The guided flow using `/create-environment` ([Slash Commands](/agent-platform/capabilities/slash-commands/)) -For full instructions, see our [Environment Setup](/platform/integrations/) docs. +For full instructions, see the [Environment Setup](/platform/integrations/) docs. #### 2. Create the Linear integration @@ -137,4 +137,4 @@ After revoking access, Warp will no longer be able to read issues, receive trigg ### Troubleshooting -If something isn't working as expected—missing repos, PR failures, Linear not detecting Oz, or environment issues—see our [Integrations Troubleshooting](/platform/integrations/#troubleshooting) page for detailed guidance on GitHub permissions, environment configuration, and common setup problems. +If something isn't working as expected—missing repos, PR failures, Linear not detecting Oz, or environment issues—see the [Integrations Troubleshooting](/platform/integrations/#troubleshooting) page for detailed guidance on GitHub permissions, environment configuration, and common setup problems. diff --git a/src/content/docs/platform/integrations/quickstart.mdx b/src/content/docs/platform/integrations/quickstart.mdx index b4b4103b8..a0a495e0d 100644 --- a/src/content/docs/platform/integrations/quickstart.mdx +++ b/src/content/docs/platform/integrations/quickstart.mdx @@ -10,7 +10,7 @@ sidebar: Oz integrations let you trigger cloud agents directly from the tools your team already uses. This guide walks you through connecting Oz to Slack. Once set up, anyone on your team can tag @Oz in a message or thread to kick off a cloud agent that runs the task and posts results back to the conversation. :::note -**Want to connect with Linear instead?** The setup is the same — just substitute `slack` with `linear` in the CLI commands, or select Linear in the Oz web app. See [Linear](/platform/integrations/linear/) for details. +**Want to connect with Linear instead?** The setup is the same — substitute `slack` with `linear` in the CLI commands, or select Linear in the Oz web app. See [Linear](/platform/integrations/linear/) for details. ::: --- diff --git a/src/content/docs/platform/skills-as-agents.mdx b/src/content/docs/platform/skills-as-agents.mdx index c6ee42253..abff85454 100644 --- a/src/content/docs/platform/skills-as-agents.mdx +++ b/src/content/docs/platform/skills-as-agents.mdx @@ -19,7 +19,7 @@ This is useful when you want: --- -## How Skills become available +## How skills become available Skill discovery depends on whether you're running a local or cloud agent. @@ -131,7 +131,7 @@ For full scheduling documentation, see [Scheduled Agents](/platform/triggers/sch --- -## Suggested Skills +## Suggested skills The [Oz web app](/platform/oz-web-app/) displays suggested agents from the public [warpdotdev/oz-skills](https://github.com/warpdotdev/oz-skills) repository. These are pre-built skills that demonstrate common use cases and can be used as starting points for your own workflows. diff --git a/src/content/docs/quickstart.mdx b/src/content/docs/quickstart.mdx index b23b17b9c..89bb802db 100644 --- a/src/content/docs/quickstart.mdx +++ b/src/content/docs/quickstart.mdx @@ -60,15 +60,15 @@ You'll notice the output looks different from a traditional terminal. Every comm **What you can do with Blocks:** -* Click a Block to select it, then press `⌘C` (macOS) or `Ctrl+Shift+C` (Windows/Linux) to copy the output -* Use `⌘↑`/`⌘↓` (macOS) or `Ctrl+↑`/`Ctrl+↓` (Windows/Linux) to navigate between Blocks +* Click a Block to select it, then press `⌘+C` (macOS) or `Ctrl+Shift+C` (Windows/Linux) to copy the output +* Use `⌘+↑`/`⌘+↓` (macOS) or `Ctrl+↑`/`Ctrl+↓` (Windows/Linux) to navigate between Blocks * Click the filter icon on a Block to search within its output Learn more about navigating, selecting, and acting on output in [Block basics](/terminal/blocks/block-basics/). ## 3. Try the input editor -Warp's input isn't a standard terminal prompt, it's a real text editor. Try the following functionality: +Warp's input isn't a standard terminal prompt. It's a real text editor. Try the following functionality: * **Multi-line editing** - Press `Shift+Enter` to add a new line. Try typing three separate `echo` lines, pressing `Shift+Enter` between each, then `Enter` to run them all at once. * **Click to place your cursor** - Click anywhere in your input to move the cursor, just like a text editor. @@ -92,7 +92,7 @@ Learn more about [Autosuggestions](/terminal/command-completions/autosuggestions Everything you've done so far has been in **terminal mode**, running shell commands the way you normally would. Warp also has **Agent Mode**, a dedicated conversation view where you interact with Oz, Warp's built-in agent, using natural language. -Start an agent conversation by pressing `⌘↩` (macOS) or `Ctrl+Shift+Enter` (Windows/Linux). Then type a prompt: +Start an agent conversation by pressing `⌘+↩` (macOS) or `Ctrl+Shift+Enter` (Windows/Linux). Then type a prompt: ``` Explain the architecture of this project diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx index e6844f422..86952d704 100644 --- a/src/content/docs/reference/cli/index.mdx +++ b/src/content/docs/reference/cli/index.mdx @@ -10,7 +10,7 @@ import { Tabs, TabItem } from '@astrojs/starlight/components'; The Oz CLI is the command-line tool for running and managing Warp's cloud agents from any terminal, script, or CI pipeline. Use it to start agents locally or in the cloud, connect MCP servers, configure integrations, and authenticate without requiring the Warp desktop app. :::note -**`warp-cli` is deprecated and has been replaced by `oz`.** If you have `warp-cli` installed, it will auto-update to `oz`. All the same commands are available, just replace `warp-cli` with `oz` in your scripts and workflows. +**`warp-cli` is deprecated and has been replaced by `oz`.** If you have `warp-cli` installed, it will auto-update to `oz`. All the same commands are available — replace `warp-cli` with `oz` in your scripts and workflows. ::: ## What is the Oz CLI? @@ -42,7 +42,7 @@ The Oz CLI is automatically distributed with the Warp desktop app and can be use 2. In the search field, find and select the **Install Oz CLI Command** action. :::note - **Note:** Administrator permissions are required to install the CLI into `/usr/local/bin` . + **Note:** Administrator permissions are required to install the CLI into `/usr/local/bin`. ::: @@ -59,7 +59,7 @@ Warp provides standalone packages for the CLI on macOS and Linux, without the Wa - On macOS, we recommend that you install and update the standalone CLI with [Homebrew](https://brew.sh/), using the [`warpdotdev/warp` tap](https://github.com/warpdotdev/homebrew-warp): + On macOS, install and update the standalone CLI with [Homebrew](https://brew.sh/), using the [`warpdotdev/warp` tap](https://github.com/warpdotdev/homebrew-warp): ```sh $ brew tap warpdotdev/warp @@ -87,7 +87,7 @@ Warp provides standalone packages for the CLI on macOS and Linux, without the Wa ::: - On Linux, we recommend that you install and update the standalone CLI through your distribution's package manager. We support `apt`, `yum`, and `pacman`. + On Linux, install and update the standalone CLI through your distribution's package manager. Warp supports `apt`, `yum`, and `pacman`. 1. Add the Warp package repository for your distribution (see the [installation instructions](/getting-started/quickstart/installation-and-setup/)). 2. Install either the stable or Preview package (replace `apt` with `yum` or `pacman` as needed): @@ -148,7 +148,7 @@ To authenticate interactively: oz login ``` -The CLI prints out a URL that you can open in any browser to login to Warp. +The CLI prints out a URL that you can open in any browser to log in to Warp. ### Checking who you're signed in as diff --git a/src/content/docs/reference/cli/integration-setup.mdx b/src/content/docs/reference/cli/integration-setup.mdx index 2b9436964..edbccd44a 100644 --- a/src/content/docs/reference/cli/integration-setup.mdx +++ b/src/content/docs/reference/cli/integration-setup.mdx @@ -14,7 +14,7 @@ This article describes the environment and integration setup that is required be * Trigger agents using Slack or Linear :::note -**You only need to complete this setup once per Warp team**. After an integration exists, anyone on the team can use it. For example, the first time a teammate triggers an agent from Slack or Linear, they'll be prompted to authorize GitHub with their own account in order for the agent to write back to repos. +**You only need to complete this setup once per Warp team**. After an integration exists, anyone on the team can use it. For example, the first time a teammate triggers an agent from Slack or Linear, they'll be prompted to authorize GitHub with their own account so the agent can write back to repos. Note: While cloud agents can be run individually via CLI without a team, integrations (Slack, Linear) require team membership. ::: diff --git a/src/content/docs/reference/cli/quickstart.mdx b/src/content/docs/reference/cli/quickstart.mdx index 3950c22ae..3da5cc28b 100644 --- a/src/content/docs/reference/cli/quickstart.mdx +++ b/src/content/docs/reference/cli/quickstart.mdx @@ -28,7 +28,7 @@ For local development and first-time setup, authenticate interactively using the oz login ``` -This command prints a sign-in URL in your terminal. Open the URL in your browser to login to Warp. Your credentials will be stored securely for future CLI use. +This command prints a sign-in URL in your terminal. Open the URL in your browser to log in to Warp. Your credentials will be stored securely for future CLI use. Interactive login works on both **local** and **remote** machines, and does not require API keys. diff --git a/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx b/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx index 08d4e3f28..5a475f818 100644 --- a/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx +++ b/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx @@ -334,7 +334,7 @@ For annual subscriptions, we can issue a full refund within 15 days if no credit Warp's promotions are a way to try Warp before committing to a subscription, not get unlimited free or inexpensive AI. To prevent abuse, we're limiting promotion codes to first-time redemptions only, so each account can only use one promotion code.\ \ -In addition certain promo codes we issue are only valid for specific plans (not all plans) and expire after a certain time. If you apply a promo code for a certain plan, then upgrade to another plan, the promotion doesn't transfer to the new plan so you will end up paying full price for the upgrade. +In addition, certain promo codes we issue are only valid for specific plans (not all plans) and expire after a certain time. If you apply a promo code for a certain plan, then upgrade to another plan, the promotion doesn't transfer to the new plan so you will end up paying full price for the upgrade. :::caution Warp reserves the right to disable any promotion codes at any time, and cancel the associated subscriptions if we find that the code was being abused. @@ -344,7 +344,7 @@ Warp reserves the right to disable any promotion codes at any time, and cancel t Warp does allow tax exempt organizations to subscribe, but there are some additional steps that you need to take. -1. Create a Warp account, login, and go to the [upgrade page](https://app.warp.dev/upgrade), and select a plan, but **don't checkout or pay yet.** This will only setup your billing account in the system that will be used in the later steps. +1. Create a Warp account, log in, and go to the [upgrade page](https://app.warp.dev/upgrade), and select a plan, but **don't checkout or pay yet.** This will only set up your billing account in the system that will be used in the later steps. 2. E-mail [billing@warp.dev](mailto:billing@warp.dev) with your proof of your organization tax exempt status and your Warp account email. 3. Warp's team will verify your tax exempt status and will change your account to tax exempt. 4. Finally, subscribe to your plan of choice. You will see no taxes applied to the bill. diff --git a/src/content/docs/support-and-community/privacy-and-security/network-log.mdx b/src/content/docs/support-and-community/privacy-and-security/network-log.mdx index d85880c46..39df4322d 100644 --- a/src/content/docs/support-and-community/privacy-and-security/network-log.mdx +++ b/src/content/docs/support-and-community/privacy-and-security/network-log.mdx @@ -10,7 +10,7 @@ import VideoEmbed from '@components/VideoEmbed.astro'; ## What is it -You can use Warp's network log to help debug issues or simply use it to understand when information is sent or received over the network throughout a Warp session. +You can use Warp's network log to help debug issues or use it to understand when information is sent or received over the network throughout a Warp session. Each log item is a timestamped Debug format string for either a request or response object handled by Warp. Messages are logged via pre-request and post-response hooks in Warp’s internal HTTP client. @@ -26,4 +26,4 @@ Each log item is a timestamped Debug format string for either a request or respo ## Known issues with network log -At the moment, network traffic originating from crash reports and error messages is not captured in the network log. This is due to our use of the Sentry SDK, which encapsulates all network logic and doesn’t currently expose a hook for handling requests and responses directly. The team is actively investigating a solution to include such traffic in the log in a future release. You may also disable Crash Reporting entirely in Warp’s **Settings** > **Privacy** tab. +At the moment, network traffic originating from crash reports and error messages is not captured in the network log. This is due to our use of the Sentry SDK, which encapsulates all network logic and doesn’t currently expose a hook for handling requests and responses directly. The team is actively investigating a solution to include such traffic in the log in a future release. You can also disable Crash Reporting entirely in Warp’s **Settings** > **Privacy** tab. diff --git a/src/content/docs/support-and-community/privacy-and-security/privacy.mdx b/src/content/docs/support-and-community/privacy-and-security/privacy.mdx index 835593ba3..00e6268ba 100644 --- a/src/content/docs/support-and-community/privacy-and-security/privacy.mdx +++ b/src/content/docs/support-and-community/privacy-and-security/privacy.mdx @@ -42,8 +42,8 @@ You can read our [full privacy policy](https://www.warp.dev/legal/privacy-policy ### How to disable telemetry and crash reporting -1. Navigate to **Settings** > **Privacy**, or open the [Command Palette](/terminal/command-palette/) and search for "privacy" -2. Toggle off "Help improve Warp", "Send crash reports", or both +1. Navigate to **Settings** > **Privacy**, or open the [Command Palette](/terminal/command-palette/) and search for "privacy". +2. Toggle off "Help improve Warp", "Send crash reports", or both. ![Privacy Settings](../../../../assets/support-and-community/privacy-settings-after-signup-1.png) @@ -89,7 +89,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `AIAutonomy.ChangedAgentModeAskUserQuestionPermission` | Changed Agent Mode permission for asking user questions | | `AIAutonomy.ChangedAgentModeCodingPermissions` | Changed Agent Mode permissions for coding tasks | | `AIAutonomy.ToggledAutoexecuteReadonlyCommandsSetting` | Toggled setting to autoexecute readonly Agent Mode requested commands | -| `Active Indexed Repos Changed` | Active indexed repositories changed, affecting codebase context. | +| `Active Indexed Repos Changed` | Active indexed repositories changed, affecting Codebase Context. | | `Add Added Subshell Command` | Added a command to be automatically Warpified via Warp's subshell wrapper | | `Add Denylisted SSH Tmux Wrapper Host` | Added a SSH host to the denylist for prompting for Tmux Wrapper | | `Add Denylisted Subshell Command` | Explicitly prevent a command from being Warpified via Warp's subshell wrapper | @@ -103,7 +103,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `Agent Mode Setup Banner Accepted` | Agent Mode setup banner accepted | | `Agent Mode Setup Banner Dismissed` | Agent Mode setup banner dismissed | | `Agent Mode Setup Project Scoped Rules Action` | User clicked a button in the Agent Mode setup project scoped rules step | -| `Agent Mode.Setup Codebase Context Action` | User clicked a button in the Agent Mode setup codebase context step | +| `Agent Mode.Setup Codebase Context Action` | User clicked a button in the Agent Mode setup Codebase Context step | | `Agent Predict` | Completed an Agent Predict prediction | | `Agent Toolbar Dismissed` | User dismissed the use-agent toolbar | | `AgentManagement.AgentTypeSelectorOpened` | User opened the agent type selector from agent management | @@ -145,14 +145,14 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `AgentMode.Code.SuggestedEditAcceptClicked` | User selected Accept for a code diff suggestion in Agent Mode | | `AgentMode.Code.SuggestedEditReceived` | Agent Mode suggested a code edit | | `AgentMode.Code.SuggestedEditResolved` | Agent Mode pending code edit suggestion resolved | -| `AgentMode.CreatedAIBlock` | Created an AI block in agent mode | +| `AgentMode.CreatedAIBlock` | Created an AI block in Agent Mode | | `AgentMode.Error` | Received an error when getting Agent Mode response | | `AgentMode.ExecutedWarpDrivePrompt` | Executed a saved prompt. | | `AgentMode.ExitedShellProcess` | An agent-requested command caused the shell process to exit | | `AgentMode.FileGlob.Failed` | The file glob tool failed to complete | | `AgentMode.FileGlob.Succeeded` | The file glob tool completed successfully | -| `AgentMode.FullEmbedCodebaseContextSearch.Failed` | Failed to search full embed codebase context | -| `AgentMode.FullEmbedCodebaseContextSearch.Success` | Successfully searched full embed codebase context | +| `AgentMode.FullEmbedCodebaseContextSearch.Failed` | Failed to search full embed Codebase Context | +| `AgentMode.FullEmbedCodebaseContextSearch.Success` | Successfully searched full embed Codebase Context | | `AgentMode.Grep.Failed` | The grep tool failed to complete | | `AgentMode.Grep.Succeeded` | The grep tool completed successfully | | `AgentMode.MerkleTreeSnapshot.Diff.Failed` | Failed to diff merkle tree snapshot | @@ -160,7 +160,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `AgentMode.MerkleTreeSnapshot.Rebuild.Failed` | Failed to rebuild merkle tree from snapshot | | `AgentMode.MerkleTreeSnapshot.Rebuild.Success` | Successfully rebuilt merkle tree from snapshot | | `AgentMode.NaturalLanguageDetection.InputBufferSubmitted` | Input buffer submitted | -| `AgentMode.OpenedCitation` | Opened a citation that was surfaced in agent mode | +| `AgentMode.OpenedCitation` | Opened a citation that was surfaced in Agent Mode | | `AgentMode.Orchestration.AgentProposedConfig` | An agent-authored orchestration config snapshot first became visible to the user on a plan card | | `AgentMode.Orchestration.Entered` | Orchestration was activated in a conversation via /orchestrate or a run_agents confirmation card surfacing. Plan-card entries are tracked separately via AgentProposedConfig + PlanConfigApprovalToggled. | | `AgentMode.Orchestration.PillBarInteraction` | User interacted with the orchestration pill bar (switch, pin, open in pane/tab, stop, kill, etc.) | @@ -171,11 +171,11 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `AgentMode.QueryAttemptAtLImit` | Tried to send an Agent Mode query but they already reached the query limit | | `AgentMode.RequestRetrySucceeded` | Agent Mode request succeeded after retrying following an initial error | | `AgentMode.SetupCreateEnvironmentAction` | User clicked a button in the Agent Mode setup create environment step | -| `AgentMode.SurfacedCitations` | Agent mode used and cited external sources that were used in its response | -| `AgentMode.SyncCodebaseContext.BuildTree.Failed` | Failed to build merkle tree for codebase context | -| `AgentMode.SyncCodebaseContext.BuildTree.Success` | Successfully built merkle tree for codebase context | -| `AgentMode.SyncCodebaseContext.Failed` | Failed to sync codebase context | -| `AgentMode.SyncCodebaseContext.Success` | Successfully synced codebase context | +| `AgentMode.SurfacedCitations` | Agent Mode used and cited external sources that were used in its response | +| `AgentMode.SyncCodebaseContext.BuildTree.Failed` | Failed to build merkle tree for Codebase Context | +| `AgentMode.SyncCodebaseContext.BuildTree.Success` | Successfully built merkle tree for Codebase Context | +| `AgentMode.SyncCodebaseContext.Failed` | Failed to sync Codebase Context | +| `AgentMode.SyncCodebaseContext.Success` | Successfully synced Codebase Context | | `AgentMode.ToggleAutoDetectionSetting` | Toggled the setting that enables or disables natural language auto-detection in the input. | | `AgentNotification.Shown` | An agent notification was shown to the user (toast or mailbox) | | `AgentTip Clicked` | User clicked a link or action in an Agent Tip | @@ -335,8 +335,8 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `CodexModal.UseCodexClicked` | User clicked 'Use Codex' in the Codex modal | | `Command Correction Event` | Accepted command correction | | `Command File Run` | Opened a .cmd or unix executable file and ran it directly in Warp | -| `Command Palette Search Accepted` | Accepted a command palette search result | -| `Command Palette Search Exited` | Exited command palette search without accepting a result | +| `Command Palette Search Accepted` | Accepted a Command Palette search result | +| `Command Palette Search Exited` | Exited Command Palette search without accepting a result | | `Command Search Async Query Completed` | Finished searching for a command in the background | | `Command Search Exited` | Exited command search (universal search panel to search) without accepting a result | | `Command Search Filter Changed` | Changed command search filter | @@ -549,7 +549,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `SSH Tmux Warpify Block Dismissed` | User dismissed an ssh tmux warpify block | | `Save Launch Config` | Saved current launch configuration of windows, tabs, and panes | | `Select App Icon` | Selected app icon | -| `Select Command Palette Option` | Selected option from command palette (i.e. CMD-P) | +| `Select Command Palette Option` | Selected option from Command Palette (i.e. CMD-P) | | `Select Cursor Type` | Selected cursor type | | `Select Navigation Palette Item` | Selected session from the Session Navigation Palette (search across panes, tabs, and windows) | | `Select Theme` | Selected theme | @@ -600,7 +600,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `Thin Strokes Setting Changed` | Changed thin strokes setting in settings -> Appearance | | `Tier Limit Hit` | User hit the tier limit for a feature | | `Toggle Active AI Enablement` | Toggled active AI enablement. | -| `Toggle Agent Mode Codebase Context` | Toggled on/off the enablement of codebase context usage for Agent Mode. | +| `Toggle Agent Mode Codebase Context` | Toggled on/off the enablement of Codebase Context usage for Agent Mode. | | `Toggle Agent Mode Query Suggestions Setting` | Toggled on/off the prompt suggestions setting | | `Toggle Approvals Modal` | Opened or closed teams modal | | `Toggle Block Filter Case Sensitivity` | Toggled on/off case sensitivity within the block filter editor | @@ -608,7 +608,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `Toggle Block Filter Query` | Toggled on/off a block filter query | | `Toggle Block Filter Regex` | Toggled on/off regex within the block filter editor | | `Toggle Code Suggestions Setting` | Toggled on/off the code suggestions setting | -| `Toggle Codebase Context Autoindexing` | Toggled on/off the enablement of autoindexing for codebase context. | +| `Toggle Codebase Context Autoindexing` | Toggled on/off the enablement of autoindexing for Codebase Context. | | `Toggle Dim Inactive Panes` | Whether the dim inactive panes feature has been toggled | | `Toggle Focus Pane On Hover` | Toggled on/off focus pane on hover feature, which causes panes to automatically focus when hovering over them | | `Toggle Git Operations Autogen Setting` | Toggled on/off the git operations autogen setting | @@ -693,7 +693,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `revenue.AutoReloadToggledFromBillingSettings` | User toggled auto-reload in Billing & Usage settings | | `revenue.OutOfCreditsBannerClosed` | User closed the 'Out of credits' banner (dismissed or purchased credits) | -### Exhaustive Telemetry Table +### Exhaustive telemetry table | Event Name | Description | |---|---| @@ -727,7 +727,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `Agent Mode Setup Banner Accepted` | Agent Mode setup banner accepted | | `Agent Mode Setup Banner Dismissed` | Agent Mode setup banner dismissed | | `Agent Mode Setup Project Scoped Rules Action` | User clicked a button in the Agent Mode setup project scoped rules step | -| `Agent Mode.Setup Codebase Context Action` | User clicked a button in the Agent Mode setup codebase context step | +| `Agent Mode.Setup Codebase Context Action` | User clicked a button in the Agent Mode setup Codebase Context step | | `Agent Predict` | Completed an Agent Predict prediction | | `Agent Toolbar Dismissed` | User dismissed the use-agent toolbar | | `AgentManagement.AgentTypeSelectorOpened` | User opened the agent type selector from agent management | @@ -769,21 +769,21 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `AgentMode.Code.SuggestedEditAcceptClicked` | User selected Accept for a code diff suggestion in Agent Mode | | `AgentMode.Code.SuggestedEditReceived` | Agent Mode suggested a code edit | | `AgentMode.Code.SuggestedEditResolved` | Agent Mode pending code edit suggestion resolved | -| `AgentMode.CreatedAIBlock` | Created an AI block in agent mode | +| `AgentMode.CreatedAIBlock` | Created an AI block in Agent Mode | | `AgentMode.Error` | Received an error when getting Agent Mode response | | `AgentMode.ExecutedWarpDrivePrompt` | Executed a saved prompt. | | `AgentMode.ExitedShellProcess` | An agent-requested command caused the shell process to exit | | `AgentMode.FileGlob.Failed` | The file glob tool failed to complete | | `AgentMode.FileGlob.Succeeded` | The file glob tool completed successfully | -| `AgentMode.FullEmbedCodebaseContextSearch.Failed` | Failed to search full embed codebase context | -| `AgentMode.FullEmbedCodebaseContextSearch.Success` | Successfully searched full embed codebase context | +| `AgentMode.FullEmbedCodebaseContextSearch.Failed` | Failed to search full embed Codebase Context | +| `AgentMode.FullEmbedCodebaseContextSearch.Success` | Successfully searched full embed Codebase Context | | `AgentMode.Grep.Failed` | The grep tool failed to complete | | `AgentMode.Grep.Succeeded` | The grep tool completed successfully | | `AgentMode.MerkleTreeSnapshot.Diff.Failed` | Failed to diff merkle tree snapshot | | `AgentMode.MerkleTreeSnapshot.Diff.Success` | Successfully diffed merkle tree snapshot | | `AgentMode.MerkleTreeSnapshot.Rebuild.Failed` | Failed to rebuild merkle tree from snapshot | | `AgentMode.MerkleTreeSnapshot.Rebuild.Success` | Successfully rebuilt merkle tree from snapshot | -| `AgentMode.OpenedCitation` | Opened a citation that was surfaced in agent mode | +| `AgentMode.OpenedCitation` | Opened a citation that was surfaced in Agent Mode | | `AgentMode.Orchestration.AgentProposedConfig` | An agent-authored orchestration config snapshot first became visible to the user on a plan card | | `AgentMode.Orchestration.Entered` | Orchestration was activated in a conversation via /orchestrate or a run_agents confirmation card surfacing. Plan-card entries are tracked separately via AgentProposedConfig + PlanConfigApprovalToggled. | | `AgentMode.Orchestration.PillBarInteraction` | User interacted with the orchestration pill bar (switch, pin, open in pane/tab, stop, kill, etc.) | @@ -793,11 +793,11 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `AgentMode.PotentialAutoDetectionFalsePositive` | Manually toggled input to shell mode after input was auto-detected as natural language. | | `AgentMode.RequestRetrySucceeded` | Agent Mode request succeeded after retrying following an initial error | | `AgentMode.SetupCreateEnvironmentAction` | User clicked a button in the Agent Mode setup create environment step | -| `AgentMode.SurfacedCitations` | Agent mode used and cited external sources that were used in its response | -| `AgentMode.SyncCodebaseContext.BuildTree.Failed` | Failed to build merkle tree for codebase context | -| `AgentMode.SyncCodebaseContext.BuildTree.Success` | Successfully built merkle tree for codebase context | -| `AgentMode.SyncCodebaseContext.Failed` | Failed to sync codebase context | -| `AgentMode.SyncCodebaseContext.Success` | Successfully synced codebase context | +| `AgentMode.SurfacedCitations` | Agent Mode used and cited external sources that were used in its response | +| `AgentMode.SyncCodebaseContext.BuildTree.Failed` | Failed to build merkle tree for Codebase Context | +| `AgentMode.SyncCodebaseContext.BuildTree.Success` | Successfully built merkle tree for Codebase Context | +| `AgentMode.SyncCodebaseContext.Failed` | Failed to sync Codebase Context | +| `AgentMode.SyncCodebaseContext.Success` | Successfully synced Codebase Context | | `AgentMode.ToggleAutoDetectionSetting` | Toggled the setting that enables or disables natural language auto-detection in the input. | | `AgentNotification.Shown` | An agent notification was shown to the user (toast or mailbox) | | `AgentTip Clicked` | User clicked a link or action in an Agent Tip | @@ -970,8 +970,8 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `CodexModal.Opened` | User opened the Codex modal | | `CodexModal.UseCodexClicked` | User clicked 'Use Codex' in the Codex modal | | `Command File Run` | Opened a .cmd or unix executable file and ran it directly in Warp | -| `Command Palette Search Accepted` | Accepted a command palette search result | -| `Command Palette Search Exited` | Exited command palette search without accepting a result | +| `Command Palette Search Accepted` | Accepted a Command Palette search result | +| `Command Palette Search Exited` | Exited Command Palette search without accepting a result | | `Command Search Exited` | Exited command search (universal search panel to search) without accepting a result | | `Command Search Opened` | Opened command search (universal search panel to search) | | `Command Search Result Accepted` | Accepted command search result | @@ -1170,7 +1170,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `SSH Remote Server Choice Do Not Ask Again Toggled` | Toggled the 'Don't ask me this again' checkbox on the SSH remote-server choice block | | `Save Launch Config` | Saved current launch configuration of windows, tabs, and panes | | `Select App Icon` | Selected app icon | -| `Select Command Palette Option` | Selected option from command palette (i.e. CMD-P) | +| `Select Command Palette Option` | Selected option from Command Palette (i.e. CMD-P) | | `Select Cursor Type` | Selected cursor type | | `Select Navigation Palette Item` | Selected session from the Session Navigation Palette (search across panes, tabs, and windows) | | `Select Theme` | Selected theme | @@ -1222,7 +1222,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `Thin Strokes Setting Changed` | Changed thin strokes setting in settings -> Appearance | | `Tier Limit Hit` | User hit the tier limit for a feature | | `Toggle Active AI Enablement` | Toggled active AI enablement. | -| `Toggle Agent Mode Codebase Context` | Toggled on/off the enablement of codebase context usage for Agent Mode. | +| `Toggle Agent Mode Codebase Context` | Toggled on/off the enablement of Codebase Context usage for Agent Mode. | | `Toggle Agent Mode Query Suggestions Setting` | Toggled on/off the prompt suggestions setting | | `Toggle Approvals Modal` | Opened or closed teams modal | | `Toggle Block Filter Case Sensitivity` | Toggled on/off case sensitivity within the block filter editor | @@ -1230,7 +1230,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `Toggle Block Filter Query` | Toggled on/off a block filter query | | `Toggle Block Filter Regex` | Toggled on/off regex within the block filter editor | | `Toggle Code Suggestions Setting` | Toggled on/off the code suggestions setting | -| `Toggle Codebase Context Autoindexing` | Toggled on/off the enablement of autoindexing for codebase context. | +| `Toggle Codebase Context Autoindexing` | Toggled on/off the enablement of autoindexing for Codebase Context. | | `Toggle Dim Inactive Panes` | Whether the dim inactive panes feature has been toggled | | `Toggle Focus Pane On Hover` | Toggled on/off focus pane on hover feature, which causes panes to automatically focus when hovering over them | | `Toggle Git Operations Autogen Setting` | Toggled on/off the git operations autogen setting | diff --git a/src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx b/src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx index 3e59d785b..747ae6acf 100644 --- a/src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx +++ b/src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx @@ -7,13 +7,13 @@ description: >- ## How to access it -Disabled by default, to enable Secret Redaction open **Settings** > **Privacy** > **Secret redaction** or type in "Secret Redaction" to toggle it in the [Command Palette](/terminal/command-palette/). +Secret Redaction is disabled by default. To enable it, open **Settings** > **Privacy** > **Secret redaction**, or type "Secret Redaction" to toggle it in the [Command Palette](/terminal/command-palette/). ## How it works Secret Redaction attempts to detect sensitive data (including secrets, passwords, API keys, and PII) using your list of regex patterns. Any identified secret will be redacted instead of being sent to our servers or any LLM provider. Additionally, Warp Drive will prevent you from saving any secrets in plain text (workflows, MCP servers, prompts, etc.).\ \ -Warp ships with a [list of recommended regex](/support-and-community/privacy-and-security/secret-redaction/#secret-regex-list) you can easily add to the list. Additionally you can add custom regex for secrets you want to include in **Settings** > **Privacy** > **Secret redaction** > **Custom secret redaction**. +Warp ships with a [list of recommended regex](/support-and-community/privacy-and-security/secret-redaction/#secret-regex-list) you can add to the list. Additionally, you can add custom regex for secrets you want to include in **Settings** > **Privacy** > **Secret redaction** > **Custom secret redaction**. ## Visually hiding secrets diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx index 02a563c8e..5f0082575 100644 --- a/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx +++ b/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx @@ -62,7 +62,7 @@ Nov 2021: We have added character support for Chinese, Korean, and Japanese, but ### Abnormal rendering of Chinese characters -If you notice issues with the terminal rendering Chinese characters (i.e. [#3366](https://github.com/warpdotdev/Warp/issues/3366)). Please try adding the following lines to your rc file. +If you notice issues with the terminal rendering Chinese characters (i.e. [#3366](https://github.com/warpdotdev/Warp/issues/3366)), try adding the following lines to your rc file. ``` export LC_ALL=zh_CN.UTF-8 @@ -71,7 +71,7 @@ export LANG=zh_CN.UTF-8 ### Warp fails to render a window -This can likely occur due to some corruption in the local sqlite db. You may see a similar error your [logs](/support-and-community/#gathering-warp-logs): +This can likely occur due to some corruption in the local sqlite db. You may see a similar error in your [logs](/support-and-community/#gathering-warp-logs): ``` [WARN] SQLite error 283 (A WAL mode database file was recovered): recovered 383 frames from WAL file /home/xxxxx/.local/state/warp-terminal/warp.sqlite-wal @@ -90,7 +90,7 @@ To try and resolve the issue of Warp not rendering a window, rename the SQLite d * Note that Agent Mode blocks are not shareable during [session sharing](/knowledge-and-collaboration/session-sharing/). Participants will be able to share regular shell commands that are run, but will not be able to share AI interactions (requested commands, AI blocks, etc.). * Block actions such as [Block Sharing](/terminal/blocks/block-sharing/) are not available on Agent Mode AI blocks. -* Agents do not have up-to-date information on several commands’ completion specs +* Agents do not have up-to-date information on several commands’ completion specs. * Agent Mode works better with Warp's default prompt settings, where the prompt starts on a new line, than it does with a same-line prompt. If you are using the same-line prompt, the cursor will jump from the end of the single line to the start of the input box when you switch to Agent Mode. ## Shells @@ -246,8 +246,8 @@ The following non-exhaustive list of plugins, prompts, or tools can cause potent In some cases, CLI applications only work on x86, so you can run Warp with Rosetta on macOS to be able to use them by doing the following. * Go to **Finder** > **Applications** and search for Warp. - * Right-click and select Get Info. - * Then check the box on Open with Rosetta. + * Right-click and select **Get Info**. + * Select **Open with Rosetta**. **Unsupported in Warp on Windows** diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx index 9cf0926d2..82da3b874 100644 --- a/src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx +++ b/src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx @@ -83,7 +83,7 @@ If you're using Warp Preview, replace "Warp-Stable" with "Warp-Preview" in the c **Uninstalling Warp installed by Installer** * Search for "Installed apps" section of the Control Panel. - * Search for and Uninstall the Warp application + * Search for and uninstall the Warp application **Removing Warp settings, files, logs, and database** diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx index 6d83a604f..2981372c2 100644 --- a/src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx +++ b/src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx @@ -256,7 +256,7 @@ Collect a sample using the steps for your platform and attach it to a new [GitHu ## Gathering AI conversation ID -To gather the conversation ID, `RIGHT-CLICK` on the AI conversation block in question and select "Copy conversation ID", then paste that into the [bug report](/support-and-community/troubleshooting-and-support/sending-us-feedback/#sending-warp-feedback) that you submit so that our team can investigate the issue. +To gather the conversation ID, right-click on the AI conversation block in question and select "Copy conversation ID", then paste that into the [bug report](/support-and-community/troubleshooting-and-support/sending-us-feedback/#sending-warp-feedback) that you submit so that our team can investigate the issue. Whenever there is an error in the Agent Conversation, there will also be an option to directly copy the conversation ID for the bug report. diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx index 20bda0756..4837c37c1 100644 --- a/src/content/docs/support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx +++ b/src/content/docs/support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx @@ -18,9 +18,9 @@ In some older Ruby development environments, `.dev` domains do not resolve prope This error could occur if you installed an ad blocker or have stale browser cookies, including our Firebase auth pop-up. **To fix it:** -1. Disable your ad blocker for `app.warp.dev` -2. Clear any cookies and cache, or open an incognito / private browser window -3. Try the [Warp login page](https://app.warp.dev/login) again +1. Disable your ad blocker for `app.warp.dev`. +2. Clear any cookies and cache, or open an incognito / private browser window. +3. Try the [Warp login page](https://app.warp.dev/login) again. ### Safari @@ -31,8 +31,8 @@ If you are using Safari, you may see the following messages in your console: This error likely occurs because you are blocking all cookies in Safari's security settings, but Firebase Auth requires the cookie to record whether the user is logged in. **To fix it:** -1. Go to Safari Preferences > Privacy -2. Uncheck the "Block all cookies" checkbox +1. Go to Safari Preferences > Privacy. +2. Deselect **Block all cookies**. ## Proxies @@ -54,20 +54,20 @@ When behind a proxy, a possible workaround is to disable QUIC in the browser. It ### Can't open Warp from SSO -When directly launching Warp from Okta or other SSO providers', you may see an error message like "`Unable to process request due to missing initial state...`". This is due to a limitation with Warp authentication APIs. Instead, do the following: +When directly launching Warp from Okta or other SSO providers, you may see an error message like "`Unable to process request due to missing initial state...`". This is due to a limitation with Warp authentication APIs. Instead, do the following: -1. Go to the [Warp login page](https://app.warp.dev/login) -2. Choose “Continue with SSO” -3. Login with your normal SSO credentials +1. Go to the [Warp login page](https://app.warp.dev/login). +2. Choose “Continue with SSO”. +3. Log in with your normal SSO credentials. ### I logged in with another method before and now can't use SSO In cases where you logged in with another method, please do the following to fix SSO login: -1. Go to the [Warp login page](https://app.warp.dev/login) -2. Login with the original method that you used to create your Warp account (email, Google, GitHub). -3. Once logged in, go to the [SSO linking page](https://app.warp.dev/link_sso) -4. This should link your login to SSO. You can now proceed to login with "Continue with SSO". +1. Go to the [Warp login page](https://app.warp.dev/login). +2. Log in with the original method that you used to create your Warp account (email, Google, GitHub). +3. Once logged in, go to the [SSO linking page](https://app.warp.dev/link_sso). +4. This should link your login to SSO. You can now proceed to log in with "Continue with SSO". ## Flagged as fraudulent @@ -85,16 +85,16 @@ If you are still unable to authenticate, you may email [appeals@warp.dev](mailto If you have an active subscription and continue to have login issues, see [how to get help with login issues](/support-and-community/troubleshooting-and-support/troubleshooting-login-issues/#get-help-with-login-issues). -## How to get an auth token to login +## How to get an auth token to log in -If the browser does not open from Warp directly when you click "Sign up" or "Sign in". Please go to the [Signup](https://app.warp.dev/signup) page to create an account or [Login](https://app.warp.dev/login) page if you already have one, then copy the auth token from the "here" link on the logged\_in page and paste it into Warp. +If the browser does not open from Warp directly when you click "Sign up" or "Sign in", go to the [Signup](https://app.warp.dev/signup) page to create an account or [Login](https://app.warp.dev/login) page if you already have one, then copy the auth token from the "here" link on the logged\_in page and paste it into Warp. -If nothing happens when you click "Take me to Warp" on the logged-in page. If this happens to you, copy the "here" link on the web logged-in page (https://app.warp.dev/logged\_in) to copy the authentication token, then paste it into the app as shown below. +If nothing happens when you click "Take me to Warp" on the logged-in page, copy the "here" link on the web logged-in page (https://app.warp.dev/logged\_in) to copy the authentication token, then paste it into the app as shown below. :::caution On Linux and Windows, the default copy-and-paste [Keyboard shortcuts](/getting-started/keyboard-shortcuts/) are `Ctrl+Shift+C` and `Ctrl+Shift+V` respectively.\ \ -On Linux and WSL you should install and set your default `$BROWSER` to `brave-browser` to workaround any copy-paste issues. Please see the workaround guide below. +On Linux and WSL you should install and set your default `$BROWSER` to `brave-browser` to work around any copy-paste issues. Please see the workaround guide below. ::: diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/using-warp-offline.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/using-warp-offline.mdx index b4672966f..cba0974dc 100644 --- a/src/content/docs/support-and-community/troubleshooting-and-support/using-warp-offline.mdx +++ b/src/content/docs/support-and-community/troubleshooting-and-support/using-warp-offline.mdx @@ -4,9 +4,9 @@ description: >- Using Warp offline and what features are supported. --- -The first time you download and open Warp, you will need to be online for the initial setup. After the initial setup Warp’s core terminal features will work as expected when you’re offline, regardless of whether you are logged in or logged out. +The first time you download and open Warp, you will need to be online for the initial setup. After the initial setup, Warp’s core terminal features will work as expected when you’re offline, regardless of whether you are logged in or logged out. -Requiring all users, logging in or logged out, to be online when first accessing Warp is required to allow use of Warp's AI and cloud features. When you first open the app, we create a unique user-ID to meter AI-usage and attach cloud objects to specific accounts. If you opt to use Warp logged-out, this unique ID is attached to an anonymous user account. +All users, whether logging in or logged out, must be online when first accessing Warp to use Warp's AI and cloud features. When you first open the app, we create a unique user-ID to meter AI-usage and attach cloud objects to specific accounts. If you opt to use Warp logged-out, this unique ID is attached to an anonymous user account. :::note Warp is "Offline" when you aren't connected to the internet, or if you're blocking calls `app.warp.dev` on your network. There is no explicit Offline Mode in Warp. diff --git a/src/content/docs/terminal/appearance/blocks-behavior.mdx b/src/content/docs/terminal/appearance/blocks-behavior.mdx index ac4661304..20f12ac87 100644 --- a/src/content/docs/terminal/appearance/blocks-behavior.mdx +++ b/src/content/docs/terminal/appearance/blocks-behavior.mdx @@ -17,7 +17,7 @@ Warp offers the option to enable Compact mode, which condenses the spacing betwe Compact mode is disabled by default, but can be toggled in the following ways: * Navigate to **Settings** > **Appearance** > **Blocks** > **Compact Mode**. -* Utilize the [Command Palette](/terminal/command-palette/), then search for "Compact mode" to toggle. +* Use the [Command Palette](/terminal/command-palette/), then search for "Compact mode" to toggle. :::note Warp will open with the same compact settings in future sessions. @@ -27,13 +27,13 @@ Warp will open with the same compact settings in future sessions. ## Block dividers -Warp [Blocks](/terminal/blocks/) are divided by horizontal lines that separate individual command input and output, they create a visual break between different commands that you run in a session. +Warp [Blocks](/terminal/blocks/) are divided by horizontal lines that separate individual command input and output. These lines create a visual break between different commands that you run in a session. ### How to toggle block dividers Block dividers are enabled by default, but can be toggled in the following ways: * Navigate to **Settings** > **Appearance** > **Blocks** > **Show block dividers**. -* Utilize the [Command Palette](/terminal/command-palette/), then search for "Block Dividers". +* Use the [Command Palette](/terminal/command-palette/), then search for "Block Dividers". diff --git a/src/content/docs/terminal/appearance/custom-themes.mdx b/src/content/docs/terminal/appearance/custom-themes.mdx index 81bd4fadf..eaf33f9ff 100644 --- a/src/content/docs/terminal/appearance/custom-themes.mdx +++ b/src/content/docs/terminal/appearance/custom-themes.mdx @@ -15,7 +15,7 @@ Examples and a collection of themes can be found in the [Warp themes repository] ## Warp's custom theme repository -We have a [repository of themes hosted on GitHub.](https://github.com/warpdotdev/themes) +We have a [repository of themes hosted on GitHub](https://github.com/warpdotdev/themes). Each theme has a preview generated in the README. @@ -259,7 +259,7 @@ If your theme has an intended custom background image, include a comment in the ## Community -All other Warp-related things can be discussed, please [contact us](/support-and-community/troubleshooting-and-support/sending-us-feedback/). +For anything else Warp-related, please [contact us](/support-and-community/troubleshooting-and-support/sending-us-feedback/). ## Open source dependencies diff --git a/src/content/docs/terminal/appearance/input-position.mdx b/src/content/docs/terminal/appearance/input-position.mdx index d20064919..fd080dea3 100644 --- a/src/content/docs/terminal/appearance/input-position.mdx +++ b/src/content/docs/terminal/appearance/input-position.mdx @@ -7,9 +7,9 @@ description: >- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; -You can select from three different input positions, which each have different modes of behavior for the flow of input/output Blocks. +You can select from three different input positions, each with different behavior for the flow of input and output Blocks. -
Input positionBehavior
Start at the top (Classic mode)When you select “start at the top,” the prompt with input will initiate at the top of the view and move down in the view as you enter commands. Blocks of input/output will stack above the prompt and command input. You can scroll up or navigate up to visit past commands. You can enter CTRL-L or the clear command at any time to return the input to the top of the screen while still maintaining your scroll history.
Pin to the top (Reverse mode)When you select “pin to the top,” the prompt with input will display pinned to the top of your terminal view. Blocks of grouped input/output will flow down the view in reverse order with your latest results at the top. You can scroll down or navigate down to visit past commands. For long-running commands, you can also click "Lock scrolling at bottom of block" to continue to follow the stdout.
Pin to the bottom (Warp mode)Warp mode starts with input pinned to the bottom of your terminal view. Blocks of grouped input/output flow up and out of view. You can scroll up or navigate up to visit past commands.
+
Input positionBehavior
Start at the top (Classic mode)When you select “start at the top,” the prompt with input will initiate at the top of the view and move down in the view as you enter commands. Blocks of input/output will stack above the prompt and command input. You can scroll up or navigate up to visit past commands. You can enter Ctrl+L or the clear command at any time to return the input to the top of the screen while still maintaining your scroll history.
Pin to the top (Reverse mode)When you select “pin to the top,” the prompt with input will display pinned to the top of your terminal view. Blocks of grouped input/output will flow down the view in reverse order with your latest results at the top. You can scroll down or navigate down to visit past commands. For long-running commands, you can also click Lock scrolling at bottom of block to continue to follow the stdout.
Pin to the bottom (Warp mode)Warp mode starts with input pinned to the bottom of your terminal view. Blocks of grouped input/output flow up and out of view. You can scroll up or navigate up to visit past commands.
## How to access it @@ -24,19 +24,19 @@ Changes to the input position take place immediately and apply to all open panes - * `CMD-K` will clear the entire list of input/output blocks for a clean view - * `CTRL-L` will move the list of input/output blocks outside of the view and past the scroll so you have a clean view and the ability to easily visit past commands - * For long Blocks, you can press `SHIFT-CMD-UP`/`SHIFT-CMD-DOWN` to scroll to the top/bottom of the selected block. + * `⌘+K` will clear the entire list of input/output blocks for a clean view + * `Ctrl+L` will move the list of input/output blocks outside of the view and past the scroll so you have a clean view and the ability to easily visit past commands + * For long Blocks, you can press `⌘+Shift+↑`/`⌘+Shift+↓` to scroll to the top/bottom of the selected block. - * `CTRL-SHIFT-K` will clear the entire list of input/output blocks for a clean view - * `CTRL-L` will move the list of input/output blocks outside of the view and past the scroll so you have a clear view and the ability to easily visit past commands - * For long Blocks, you can press `CTRL-SHIFT-UP`/`CTRL-SHIFT-DOWN` to scroll to the top/bottom of the selected block. + * `Ctrl+Shift+K` will clear the entire list of input/output blocks for a clean view + * `Ctrl+L` will move the list of input/output blocks outside of the view and past the scroll so you have a clear view and the ability to easily visit past commands + * For long Blocks, you can press `Ctrl+Shift+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block. - * `CTRL-SHIFT-K` will clear the entire list of input/output blocks for a clean view - * `CTRL-L` will move the list of input/output blocks outside of the view and past the scroll so you have a clear view and the ability to easily visit past commands - * For long Blocks, you can press `CTRL-SHIFT-UP`/`CTRL-SHIFT-DOWN` to scroll to the top/bottom of the selected block. + * `Ctrl+Shift+K` will clear the entire list of input/output blocks for a clean view + * `Ctrl+L` will move the list of input/output blocks outside of the view and past the scroll so you have a clear view and the ability to easily visit past commands + * For long Blocks, you can press `Ctrl+Shift+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block. diff --git a/src/content/docs/terminal/appearance/prompt.mdx b/src/content/docs/terminal/appearance/prompt.mdx index d790297ac..adfba0d54 100644 --- a/src/content/docs/terminal/appearance/prompt.mdx +++ b/src/content/docs/terminal/appearance/prompt.mdx @@ -76,12 +76,12 @@ To enable the Shell prompt: 3. Configure your PS1 variable in your shell's RC file, or install a supported prompt plugin. :::note -The PS1 is a variable used by the shell to generate the prompt, it represents the primary prompt string (hence the "PS") - which the terminal typically displays before typing new commands. +The PS1 is a variable used by the shell to generate the prompt. It represents the primary prompt string (hence "PS"), which the terminal typically displays before you type new commands. ::: ### Multi-line and right-sided prompts -The Shell prompt supports multi-line or right-sided prompts in zsh and fish, not bash. However, you can't have a multiline right-side prompt, only a multiline left prompt. +The Shell prompt supports multi-line or right-sided prompts in zsh and fish, not bash. However, you can't have a multi-line right-side prompt, only a multi-line left prompt. :::note If you want to add a new line to your Shell prompt, run the following based on your shell or prompt: @@ -210,7 +210,7 @@ Although Warp does have support for prezto's prompt, enabling the [prezto utilit ### Disabling unsupported prompts for Warp -We advise using Warp's default prompt or installing one of the supported tools, see [Compatibility Table](/terminal/appearance/prompt/#shell-prompt-compatibility-table). You can disable unsupported prompts for Warp as such: +We advise using Warp's default prompt or installing one of the supported tools. See the [Compatibility Table](/terminal/appearance/prompt/#shell-prompt-compatibility-table). You can disable unsupported prompts for Warp as such: ``` if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then @@ -224,7 +224,7 @@ fi #### iTerm2 -The iTerm2 shell integration breaks Warp and your custom prompt will not be able to be visible with this on. If you're coming from iTerm2 please check your dotfiles for it. We advise disabling the integration for Warp like so: +The iTerm2 shell integration breaks Warp, and your custom prompt won't be visible while it's on. If you're coming from iTerm2, check your dotfiles for it. We advise disabling the integration for Warp like so: ``` if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then diff --git a/src/content/docs/terminal/appearance/size-opacity-blurring.mdx b/src/content/docs/terminal/appearance/size-opacity-blurring.mdx index 75e761767..e1c1b96c8 100644 --- a/src/content/docs/terminal/appearance/size-opacity-blurring.mdx +++ b/src/content/docs/terminal/appearance/size-opacity-blurring.mdx @@ -15,7 +15,7 @@ import VideoEmbed from '@components/VideoEmbed.astro'; To access size settings, go to **Settings** > **Appearance** > **Window**. -* Enable "Open new windows with custom size", then configure your preferred columns and rows. +* Enable **Open new windows with custom size**, then configure your preferred columns and rows. :::note If [Session Restoration](/terminal/sessions/session-restoration/) is enabled, Warp will restore the size of the last window closed when you quit the app. Either make sure the custom-sized window is the last one closed, or disable Session Restoration to ensure Warp launches with the custom-sized window. diff --git a/src/content/docs/terminal/appearance/tabs-behavior.mdx b/src/content/docs/terminal/appearance/tabs-behavior.mdx index 21dd64e01..f6a57f447 100644 --- a/src/content/docs/terminal/appearance/tabs-behavior.mdx +++ b/src/content/docs/terminal/appearance/tabs-behavior.mdx @@ -10,7 +10,7 @@ import DemoVideo from '@components/DemoVideo.astro'; ## Tab indicators -Tab indicators provide visual cues in the tab bar under certain specific conditions: When the current pane is maximized, when panes or tabs are synchronized, and when a command exits with an error. These indicators serve as quick references. +Tab indicators provide visual cues in the tab bar under specific conditions: when the current pane is maximized, when panes or tabs are synchronized, and when a command exits with an error. These indicators serve as quick references. ### How to toggle tab indicators @@ -46,6 +46,6 @@ You can configure the position of the tab close button to be either on the left Navigate to **Settings** > **Appearance** > **Tabs** > **Tab close button position**, then choose from the following options: * Left - the close button will be on the left side of the tab (macOS style) -* Right – the close button will be on the right side of the tab (Windows | Linux style)\ +* Right - the close button will be on the right side of the tab (Windows | Linux style)\ diff --git a/src/content/docs/terminal/appearance/text-fonts-cursor.mdx b/src/content/docs/terminal/appearance/text-fonts-cursor.mdx index 1aafb2aff..8084738e1 100644 --- a/src/content/docs/terminal/appearance/text-fonts-cursor.mdx +++ b/src/content/docs/terminal/appearance/text-fonts-cursor.mdx @@ -10,7 +10,7 @@ sidebar: import VideoEmbed from '@components/VideoEmbed.astro'; :::note -Once a new font is installed in your system, you need to restart Warp for it to show on the list of options. You may also need to check "View all available system fonts" to see the new font. +Once a new font is installed in your system, you need to restart Warp for it to show on the list of options. You may also need to select **View all available system fonts** to see the new font. ::: ## How to use it @@ -29,7 +29,7 @@ From there you can customize: * The default setting prevents text from being blurry on low-DPI displays. :::caution -On Linux, Warp does not support the "Use thin strokes" feature. +On Linux, Warp does not support the **Use thin strokes** feature. ::: * Enforce minimum contrast @@ -47,10 +47,10 @@ To access it, go to **Settings** > **Appearance** > **Cursor** From there you can customize: * Set the cursor type to Bar, Block, or Underline. -* Toggle the Blinking cursor or from the [Command Palette](/terminal/command-palette/), type "Cursor blink" and toggle the setting. +* Toggle **Blinking cursor**, or type "Cursor blink" in the [Command Palette](/terminal/command-palette/) and toggle the setting. :::note -Cursor type preference is disabled while [Vim keybindings](/terminal/editor/vim/) (vim mode) is active. +Cursor type preference is disabled while [Vim keybindings](/terminal/editor/vim/) (vim mode) are active. ::: ## How it works diff --git a/src/content/docs/terminal/appearance/themes.mdx b/src/content/docs/terminal/appearance/themes.mdx index 78ef38856..ec0f87d0a 100644 --- a/src/content/docs/terminal/appearance/themes.mdx +++ b/src/content/docs/terminal/appearance/themes.mdx @@ -51,14 +51,14 @@ Automatically create new themes based on a background image. 1. Go to **Settings** > **Appearance** > **Themes** or search "Open theme picker" within the [Command Palette](/terminal/command-palette/). 2. Click the **+** button in the theme picker. 3. Upload the image and select the background color. -4. Click "Create Theme" to save and accept the new theme. +4. Click **Create Theme** to save and accept the new theme. ### OS theme sync Warp supports synchronizing your theme with the OS’s light and dark themes. To enable this: 1. Open the **Settings** > **Appearance** dialog. -2. Click the toggle "Sync with OS". +2. Toggle **Sync with OS**. 3. You will then be able to select a specific theme for when the OS is in light mode and dark mode. ## How it works diff --git a/src/content/docs/terminal/blocks/block-actions.mdx b/src/content/docs/terminal/blocks/block-actions.mdx index 6d355d7a3..8b32add42 100644 --- a/src/content/docs/terminal/blocks/block-actions.mdx +++ b/src/content/docs/terminal/blocks/block-actions.mdx @@ -20,9 +20,9 @@ There are 2 ways you can access Block actions. ## Copy input / output of block -For command blocks, you can `RIGHT-CLICK` on a Block or click the context menu and copy the Block command, output, or both. +For command blocks, you can right-click on a Block or click the context menu and copy the Block command, output, or both. -For AI blocks, you can `RIGHT-CLICK` to copy the prompt, output, both, or the entire conversation. +For AI blocks, you can right-click to copy the prompt, output, both, or the entire conversation. @@ -39,38 +39,38 @@ Quickly navigate to important Blocks despite where they are in the terminal hist Ways to bookmark a Block: 1. Select **Toggle bookmark** in the block context menu - 2. Use `CMD-B` keybinding to bookmark a selected block + 2. Use `⌘+B` keybinding to bookmark a selected block Navigate to a bookmarked Block, by: * Clicking on the indicator.\ The indicator position reflects the approximate position of the Block in the Block history. Hovering over the indicator will give a snapshot of the Block including its prompt, command, and the last two lines of output. - * Pressing `OPTION-UP` and `OPTION-DOWN` + * Pressing `⌥+↑` and `⌥+↓` Ways to bookmark a Block: 1. Select **Toggle bookmark** in the block context menu - 2. Use `CTRL-SHIFT-B` keybinding to bookmark a selected block + 2. Use `Ctrl+Shift+B` keybinding to bookmark a selected block Navigate to a bookmarked Block, by: * Clicking on the indicator.\ The indicator position reflects the approximate position of the Block in the Block history. Hovering over the indicator will give a snapshot of the Block including its prompt, command, and the last two lines of output. - * Pressing `ALT-UP` and `ALT-DOWN` + * Pressing `Alt+↑` and `Alt+↓` Ways to bookmark a Block: 1. Click on the bookmark icon in the top right corner of a Block 2. Select **Toggle bookmark** in the block context menu - 3. Use `CTRL-SHIFT-B` keybinding to bookmark a selected block + 3. Use `Ctrl+Shift+B` keybinding to bookmark a selected block Navigate to a bookmarked Block, by: * Clicking on the indicator.\ The indicator position reflects the approximate position of the Block in the Block history. Hovering over the indicator will give a snapshot of the Block including its prompt, command, and the last two lines of output. - * Pressing `ALT-UP` and `ALT-DOWN` + * Pressing `Alt+↑` and `Alt+↓` @@ -86,13 +86,13 @@ Quickly find important information within a Block. See the [Find page](/terminal - With a Block selected, press "Find Within Block" or use `CMD-F` to search within a Block. + With a Block selected, press **Find Within Block** or use `⌘+F` to search within a Block. - With a Block selected, press "Find Within Block" or use `CTRL-SHIFT-F` to search within a Block. + With a Block selected, press **Find Within Block** or use `Ctrl+Shift+F` to search within a Block. - With a Block selected, press "Find Within Block" or use `CTRL-SHIFT-F` to search within a Block. + With a Block selected, press **Find Within Block** or use `Ctrl+Shift+F` to search within a Block. @@ -104,15 +104,15 @@ Filter the output lines of a block natively in Warp to quickly focus on a subset - * Using the keybinding `OPT-SHIFT-F` by default to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `⌥+Shift+F` by default to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu - * Using the keybinding `ALT-SHIFT-F` to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `Alt+Shift+F` to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu - * Using the keybinding `ALT-SHIFT-F` to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `Alt+Shift+F` to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu diff --git a/src/content/docs/terminal/blocks/block-basics.mdx b/src/content/docs/terminal/blocks/block-basics.mdx index 07a86d852..dfebc53b9 100644 --- a/src/content/docs/terminal/blocks/block-basics.mdx +++ b/src/content/docs/terminal/blocks/block-basics.mdx @@ -17,14 +17,14 @@ import VideoEmbed from '@components/VideoEmbed.astro'; :::note Try it yourself!\ -Type `xyz` (or some other command that doesn’t exist) and hit `ENTER` +Type `xyz` (or some other command that doesn’t exist) and hit `Enter` ::: ## Create a block -1. Execute a command (type `ls` and hit `ENTER`) in the Input Editor at the bottom of the screen. +1. Execute a command (type `ls` and hit `Enter`) in the Input Editor at the bottom of the screen. 2. Your command and output are grouped into a Block. -3. Try executing a different command (type `echo hello` and hit `ENTER`). +3. Try executing a different command (type `echo hello` and hit `Enter`). 4. Warp adds your newly created Block to the bottom (directly above the input editor). @@ -34,26 +34,26 @@ Type `xyz` (or some other command that doesn’t exist) and hit `ENTER` * Using your mouse: click on a Block. - * Or using your keyboard: hit `CMD-UP` (or `CMD-DOWN` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. + * Or using your keyboard: hit `⌘+↑` (or `⌘+↓` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. * For long Blocks: * You can click "Jump to the bottom of this block". - * You can press `SHIFT-CMD-UP`/`SHIFT-CMD-DOWN` to scroll to the top/bottom of the selected block. + * You can press `⌘+Shift+↑`/`⌘+Shift+↓` to scroll to the top/bottom of the selected block. * From the [Command Palette](/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block". * Using your mouse: click on a Block. - * Or using your keyboard: hit `CTRL-UP` (or `CTRL-DOWN` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. + * Or using your keyboard: hit `Ctrl+↑` (or `Ctrl+↓` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. * For long Blocks: * You can click "Jump to the bottom of this block". - * You can press `CTRL-SHIFT-UP`/`CTRL-SHIFT-DOWN` to scroll to the top/bottom of the selected block. + * You can press `Ctrl+Shift+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block. * From the [Command Palette](/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block". * Using your mouse: click on a Block. - * Or using your keyboard: hit `CTRL-UP` (or `CTRL-DOWN` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. + * Or using your keyboard: hit `Ctrl+↑` (or `Ctrl+↓` if input is pinned up top) to select the most recently executed Block and use the `UP ↑` and `DOWN ↓` arrow keys to navigate to the desired Block. * For long Blocks: * You can click "Jump to the bottom of this block". - * You can press `CTRL-SHIFT-UP`/`CTRL-SHIFT-DOWN` to scroll to the top/bottom of the selected block. + * You can press `Ctrl+Shift+↑`/`Ctrl+Shift+↓` to scroll to the top/bottom of the selected block. * From the [Command Palette](/terminal/command-palette/), you can also "Scroll to the top/bottom of selected block". @@ -64,19 +64,19 @@ Type `xyz` (or some other command that doesn’t exist) and hit `ENTER` - * Click another Block while holding `CMD` to toggle the selection of that Block, or - * Click another Block while holding `SHIFT` to select a range of Blocks, or - * Use `SHIFT-UP ↑` or `SHIFT-DOWN ↓` to expand the active selection (the Block with the thicker border) up or down, respectively. + * Click another Block while holding `⌘` to toggle the selection of that Block, or + * Click another Block while holding `Shift` to select a range of Blocks, or + * Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively. - * Click another Block while holding `CTRL-SHIFT` to toggle the selection of that Block, or - * Click another Block while holding `SHIFT` to select a range of Blocks, or - * Use `SHIFT-UP ↑` or `SHIFT-DOWN ↓` to expand the active selection (the Block with the thicker border) up or down, respectively. + * Click another Block while holding `Ctrl+Shift` to toggle the selection of that Block, or + * Click another Block while holding `Shift` to select a range of Blocks, or + * Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively. - * Click another Block while holding `CTRL-SHIFT` to toggle the selection of that Block, or - * Click another Block while holding `SHIFT` to select a range of Blocks, or - * Use `SHIFT-UP ↑` or `SHIFT-DOWN ↓` to expand the active selection (the Block with the thicker border) up or down, respectively. + * Click another Block while holding `Ctrl+Shift` to toggle the selection of that Block, or + * Click another Block while holding `Shift` to select a range of Blocks, or + * Use `Shift+↑` or `Shift+↓` to expand the active selection (the Block with the thicker border) up or down, respectively. @@ -88,34 +88,34 @@ Type `xyz` (or some other command that doesn’t exist) and hit `ENTER` * **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar. * **Arrow keys** - Select a Block and use `UP ↑` and `DOWN ↓` to move between Blocks. - * **Page scrolling** - Press `PAGE UP` or `PAGE DOWN` to scroll by one page. - * **Jump to top or bottom** - Press `HOME` or `END` to scroll to the top or bottom of terminal output. - * **Scroll within a selected Block** - Press `SHIFT-CMD-UP` or `SHIFT-CMD-DOWN` to scroll to the top or bottom of the selected Block. + * **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page. + * **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output. + * **Scroll within a selected Block** - Press `Ctrl+Shift+↑` or `Ctrl+Shift+↓` to scroll to the top or bottom of the selected Block. * **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](/terminal/command-palette/). * When the output of a command is cut off, Warp keeps the [Sticky Command Header](/terminal/blocks/sticky-command-header/) pinned at the top that displays the command the Block corresponds to. Clicking the header will scroll the screen to the start of the Block. * **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar. * **Arrow keys** - Select a Block and use `UP ↑` and `DOWN ↓` to move between Blocks. - * **Page scrolling** - Press `PAGE UP` or `PAGE DOWN` to scroll by one page. - * **Jump to top or bottom** - Press `HOME` or `END` to scroll to the top or bottom of terminal output. - * **Scroll within a selected Block** - Press `CTRL-SHIFT-UP` or `CTRL-SHIFT-DOWN` to scroll to the top or bottom of the selected Block. + * **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page. + * **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output. + * **Scroll within a selected Block** - Press `Ctrl+Shift+↑` or `Ctrl+Shift+↓` to scroll to the top or bottom of the selected Block. * **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](/terminal/command-palette/). * When the output of a command is cut off, Warp keeps the [Sticky Command Header](/terminal/blocks/sticky-command-header/) pinned at the top that displays the command the Block corresponds to. Clicking the header will scroll the screen to the start of the Block. * **Mouse or scrollbar** - Scroll using your mouse, trackpad, or the scrollbar. * **Arrow keys** - Select a Block and use `UP ↑` and `DOWN ↓` to move between Blocks. - * **Page scrolling** - Press `PAGE UP` or `PAGE DOWN` to scroll by one page. - * **Jump to top or bottom** - Press `HOME` or `END` to scroll to the top or bottom of terminal output. - * **Scroll within a selected Block** - Press `CTRL-SHIFT-UP` or `CTRL-SHIFT-DOWN` to scroll to the top or bottom of the selected Block. + * **Page scrolling** - Press `Page Up` or `Page Down` to scroll by one page. + * **Jump to top or bottom** - Press `Home` or `End` to scroll to the top or bottom of terminal output. + * **Scroll within a selected Block** - Press `Ctrl+Shift+↑` or `Ctrl+Shift+↓` to scroll to the top or bottom of the selected Block. * **Scroll one line at a time** - "Scroll Terminal output up/down one line" can be configured with a keyboard shortcut in **Settings** > **Keyboard shortcuts** or accessed from the [Command Palette](/terminal/command-palette/). * When the output of a command is cut off, Warp keeps the [Sticky Command Header](/terminal/blocks/sticky-command-header/) pinned at the top that displays the command the Block corresponds to. Clicking the header will scroll the screen to the start of the Block. :::note -During long-running or full-screen commands, `PAGE UP`, `PAGE DOWN`, `HOME`, and `END` are forwarded to the running program. See the full list of scrolling shortcuts on the [Keyboard Shortcuts](/getting-started/keyboard-shortcuts/) page. +During long-running or full-screen commands, `Page Up`, `Page Down`, `Home`, and `End` are forwarded to the running program. See the full list of scrolling shortcuts on the [Keyboard Shortcuts](/getting-started/keyboard-shortcuts/) page. ::: diff --git a/src/content/docs/terminal/blocks/block-filtering.mdx b/src/content/docs/terminal/blocks/block-filtering.mdx index aa1c5f750..7214f320e 100644 --- a/src/content/docs/terminal/blocks/block-filtering.mdx +++ b/src/content/docs/terminal/blocks/block-filtering.mdx @@ -26,20 +26,20 @@ To apply a filter to a block: You can also toggle a filter by: - * Using the keybinding `OPT-SHIFT-F` by default to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `⌥+Shift+F` by default to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu You can also toggle a filter on/off by: - * Using the keybinding `ALT-SHIFT-F` to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `Alt+Shift+F` to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu You can also toggle a filter on/off by: - * Using the keybinding `ALT-SHIFT-F` to toggle filtering on the selected or latest block - * Selecting `Toggle Block Filter` in the block context menu + * Using the keybinding `Alt+Shift+F` to toggle filtering on the selected or latest block + * Selecting **Toggle Block Filter** in the block context menu diff --git a/src/content/docs/terminal/blocks/block-sharing.mdx b/src/content/docs/terminal/blocks/block-sharing.mdx index ee3a3fa6d..2b7e3562c 100644 --- a/src/content/docs/terminal/blocks/block-sharing.mdx +++ b/src/content/docs/terminal/blocks/block-sharing.mdx @@ -21,9 +21,9 @@ Share your blocks with a permalink or HTML embed. You can get started with share To share your blocks, follow these steps: - 1. On a finished block, click the context menu and select **Share...** or select the block and hit `CMD-SHIFT-S`. + 1. On a finished block, click the context menu and select **Share...** or select the block and hit `⌘+Shift+S`. 2. A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.). - 3. Click either "Create link" or "Get embed" depending on how you want to share your block. + 3. Click either **Create link** or **Get embed** depending on how you want to share your block. 4. The link or embed snippet will be copied to your clipboard. @@ -31,7 +31,7 @@ Share your blocks with a permalink or HTML embed. You can get started with share 1. On a finished block, click the context menu and select **Share...**, or set up a key bind for Share Block in **Settings** > **Keyboard shortcuts**. 2. A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.). - 3. Click either "Create link" or "Get embed" depending on how you want to share your block. + 3. Click either **Create link** or **Get embed** depending on how you want to share your block. 4. The link or embed snippet will be copied to your clipboard. @@ -39,7 +39,7 @@ Share your blocks with a permalink or HTML embed. You can get started with share 1. On a finished block, click the context menu and select **Share...**, or set up a key bind for Share Block in **Settings** > **Keyboard shortcuts**. 2. A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.). - 3. Click either "Create link" or "Get embed" depending on how you want to share your block. + 3. Click either **Create link** or **Get embed** depending on how you want to share your block. 4. The link or embed snippet will be copied to your clipboard. @@ -58,7 +58,7 @@ Create and share a permalink to your blocks to collaborate with teammates. Here ## Embedded blocks -Create and embed your blocks on web pages to help your readers follow along with technical writing. Readers can interact with an embedded block as they would with a block in Warp, with a context menu and styling. When you click "Get embed", Warp will copy an `iframe` to your clipboard. Here's an example `iframe`: +Create and embed your blocks on web pages to help your readers follow along with technical writing. Readers can interact with an embedded block as they would with a block in Warp, with a context menu and styling. When you click **Get embed**, Warp will copy an `iframe` to your clipboard. Here's an example `iframe`: ```html