Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/content/docs/agents/capabilities/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,4 @@ Agent capabilities are the core building blocks that define how agents operate,
## Related

* [Inference & providers](/agents/inference/model-choice/) - Pick the model that powers your agents, bring your own API key, or connect a custom inference endpoint.
* [Using the Warp Agent](/agents/local-agents/overview/) - Hands-on agent interactions in Warp.
* [Agents overview](/agents/) - What the Warp Agent does, how to control it, and where to run it.
24 changes: 1 addition & 23 deletions src/content/docs/agents/cli/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,35 +32,13 @@ To get a working setup in a few minutes, follow the [quickstart](/agents/cli/qui
* **The Warp app** - The CLI runs the same [Warp Agent](/platform/harnesses/warp-agent/) harness as the Warp app, so your account, plan, model access, rules, and skills work the same in both. The CLI doesn't require the Warp app to be installed.
* **{VARS.WARP_AUTOMATION_PLATFORM}** - {VARS.WARP_AUTOMATION_PLATFORM} is Warp's programmable platform for running and coordinating agents at scale. The CLI connects to the same platform. Conversations sync to your Warp account, and you can hand work off to [cloud agents](/agents/cli/cloud-and-orchestration/) or continue a cloud run from your terminal.

## Supported platforms

The CLI runs on:

* **macOS** - Apple Silicon and Intel.
* **Linux** - x64 and Arm64.
* **Windows** - x64 and Arm64.

## Logging in and out

You sign in once, and the CLI stays signed in across sessions.

* **Sign in through your browser** - The first time you run `warp`, the CLI shows a verification link and code and opens the link in your browser. It unlocks automatically once you approve the login. See [logging in](/agents/cli/quickstart/#2-log-in) for the full walkthrough.
* **Sign in with an API key** - In non-interactive environments such as CI, authenticate with a Warp API key through the `WARP_API_KEY` environment variable or the `--api-key` flag. See [command-line flags](/agents/cli/reference/#command-line-flags).
* **Sign out** - Run `/logout`. The CLI returns to its login screen and opens Warp's web sign-out page, so your browser session is signed out too.

## Automatic updates

The CLI updates automatically. While it runs, it periodically checks for a newer version, downloads it in the background, and stages it without interrupting your session. The staged version takes effect the next time you launch `warp`. When an update is ready, the start screen shows an "update installed, restart to apply" notice next to the version.

To turn off background updates, set `general.autoupdate_enabled` to `false` in the [settings file](/agents/cli/configuration/#the-settings-file). To turn them off for a single launch, set the `WARP_TUI_DISABLE_AUTOUPDATE` environment variable to any value.

## Coming from the Warp app

If you already use the Warp app, most of your setup carries over. Rules and skills are discovered from the same shared paths, and your saved Warp Drive prompts are available after you log in (other Warp Drive object types aren't available in the CLI). To copy compatible settings and global MCP server configurations, run the bundled `/tui-migrate-setup` skill and follow the agent's instructions. Credentials are never copied, so MCP servers that require authentication must be reauthenticated in the CLI.

## Next steps

* [Quickstart](/agents/cli/quickstart/) - Install the CLI, log in, and run your first prompt.
* [Quickstart](/agents/cli/quickstart/) - Install the CLI, log in, run your first prompt, and see the supported platforms.
* [Agent conversations](/agents/cli/agent-conversations/) - Learn how the transcript, diffs, and approvals work.
* [Input and shell commands](/agents/cli/input-and-shell-commands/) - Compose prompts and run shell commands from the same input.
* [Configuration](/agents/cli/configuration/) - Customize the CLI with the settings file.
Expand Down
12 changes: 9 additions & 3 deletions src/content/docs/agents/cli/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ This guide takes you from installing the {VARS.WARP_CLI} to your first agent con
## Prerequisites

* **A Warp account** - The login step opens your browser, where you can sign in or [create an account](https://app.warp.dev/signup). The CLI uses the same account as the Warp app, but doesn't require the app to be installed.
* **A supported platform** - macOS, Linux, or Windows. See [supported platforms](/agents/cli/#supported-platforms).
* **A supported platform** - macOS (Apple Silicon or Intel), Linux (x64 or Arm64), or Windows (x64 or Arm64).

## 1. Install the Warp Agent CLI

Expand All @@ -39,7 +39,13 @@ After installing, verify that the `warp` command is available:
warp --version
```

The command prints the installed version. From here on, the CLI updates automatically. See [automatic updates](/agents/cli/#automatic-updates).
The command prints the installed version.

:::note
The CLI keeps itself up to date. While it runs, it periodically checks for a newer version, downloads it in the background, and stages it without interrupting your session. The staged version takes effect the next time you launch `warp`, and the start screen shows an "update installed, restart to apply" notice next to the version.

To turn off background updates, set `general.autoupdate_enabled` to `false` in the [settings file](/agents/cli/configuration/#the-settings-file). To turn them off for a single launch, set the `WARP_TUI_DISABLE_AUTOUPDATE` environment variable to any value.
:::

## 2. Log in

Expand All @@ -51,7 +57,7 @@ warp

The CLI shows a verification link and a device code, and opens the link in your browser. Approve the login there and the CLI unlocks automatically, so you don't need to restart it. If the browser doesn't open, visit the link shown in the CLI and enter the code.

When login completes, the CLI shows its start screen with the version, a short "What's new" list, and the rules, skills, and MCP servers it discovered for your current directory.
When login completes, the CLI shows its start screen with the version, a short "What's new" list, and the rules, skills, and MCP servers it discovered for your current directory. You stay signed in across sessions. To sign out later, run `/logout`, which returns the CLI to its login screen and signs out your browser session too.

:::note
**Running in CI or a headless environment?** Authenticate with a Warp API key instead by setting the `WARP_API_KEY` environment variable:
Expand Down
102 changes: 0 additions & 102 deletions src/content/docs/agents/getting-started/agents-in-warp.mdx

This file was deleted.

Loading
Loading