diff --git a/src/content/docs/404.mdx b/src/content/docs/404.mdx
index 6e76c0370..406898f9f 100644
--- a/src/content/docs/404.mdx
+++ b/src/content/docs/404.mdx
@@ -16,6 +16,6 @@ import Docs404Tracking from '@components/Docs404Tracking.astro';
The page you are looking for does not exist or has been moved. Use the search or navigation to find what you need.
-[Go to the docs home](/)
+[Go to the docs home](/platform/)
diff --git a/src/content/docs/agent-platform/warp-tui/getting-started.mdx b/src/content/docs/agent-platform/warp-tui/getting-started.mdx
new file mode 100644
index 000000000..a8457e768
--- /dev/null
+++ b/src/content/docs/agent-platform/warp-tui/getting-started.mdx
@@ -0,0 +1,32 @@
+---
+title: Getting started with Warp Agent CLI
+description: >-
+ Install and run the Warp TUI to use Warp's agent from any terminal
+ without installing the Warp app.
+sidebar:
+ label: Getting started
+---
+
+:::note
+The Warp TUI is coming soon. Installation instructions will be added here at launch.
+:::
+
+The Warp TUI gives you an interactive agent session in your terminal by running a single command. No Warp app installation required.
+
+## Requirements
+
+- Any terminal (macOS, Linux, Windows)
+- Works inside IDEs (VS Code terminal, JetBrains, etc.)
+- Works in cloud environments and remote dev boxes
+
+## Run the TUI
+
+```bash
+/warp
+```
+
+This opens an interactive interface similar to the Claude Code CLI — you can prompt Warp's agent, review responses, and iterate from wherever you work.
+
+## Supported environments
+
+The Warp TUI works in any terminal that supports standard I/O. It connects to the same Warp agents available in the Warp app and will eventually support kicking off [Software Factory](/platform/software-factory/) runs directly from the TUI.
diff --git a/src/content/docs/agent-platform/warp-tui/overview.mdx b/src/content/docs/agent-platform/warp-tui/overview.mdx
new file mode 100644
index 000000000..1f853f79e
--- /dev/null
+++ b/src/content/docs/agent-platform/warp-tui/overview.mdx
@@ -0,0 +1,26 @@
+---
+title: Warp Agent CLI
+description: >-
+ The Warp TUI lets you use Warp's agent from any terminal, IDE, or cloud
+ environment — no Warp app installation required.
+sidebar:
+ label: Overview
+---
+
+:::note
+The Warp TUI is coming soon. This page will be updated when it launches.
+:::
+
+The Warp TUI opens an interactive agent interface directly in your terminal when you run `/warp`. It gives you access to Warp's agents from any environment — your IDE terminal, a cloud shell, or a terminal of your choice — without installing the Warp app.
+
+## Why Warp TUI
+
+Using Warp's agents today requires downloading the Warp application. The Warp TUI removes that requirement, giving developers a new entry point:
+
+- Run Warp agents from any terminal or IDE
+- Use Warp in cloud environments and remote dev boxes
+- Kick off Software Factory runs from wherever you work
+
+## Getting started
+
+See [Getting started with Warp TUI](/agent-platform/warp-tui/getting-started/) to install and run your first session.
diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx
deleted file mode 100644
index d505a68a6..000000000
--- a/src/content/docs/index.mdx
+++ /dev/null
@@ -1,109 +0,0 @@
----
-title: Getting started with Warp and Oz
-description: >-
- Get started with Warp, the Agentic Development Environment, and Oz, the
- orchestration platform for cloud agents.
-sidebar:
- label: Getting started with Warp and Oz
----
-import VideoEmbed from '@components/VideoEmbed.astro';
-
-Warp is an [open source](https://github.com/warpdotdev/warp) **Agentic Development Environment** that combines a modern, high-performance terminal with powerful agents to help you build, test, deploy, and debug code. Warp's agents are powered by **Oz**, the orchestration platform for running agents locally or in the cloud at scale.
-
-
-
-Warp terminal with Oz orchestration.
-
-
----
-
-## Warp
-
-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.
-
-
-
----
-
-## Oz: The orchestration platform for cloud agents
-
-Oz is the orchestration platform for cloud agents that powers all of Warp's intelligent features. Oz is designed to coordinate agents at scale—understanding your codebase, executing tasks autonomously, and adapting to your workflows. Oz is multi-model by design, giving you flexibility to choose the best LLM for each task.
-
-Oz operates in two modes:
-
-### Local agents
-
-Run directly in the Warp app for real-time, interactive coding assistance.
-
-* Write and refactor code across your codebase
-* Debug issues and fix errors
-* Run commands and interpret results
-* Plan and execute multi-step tasks
-
-Local agents keep you in control. You can review changes, steer the agent mid-task, and approve actions before they execute.
-
-→ [Get started with local agents](/agent-platform/local-agents/overview/)
-
-### Cloud agents
-
-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
-
-Cloud agents are ideal for work that doesn't need your immediate attention, like PR reviews, issue triage, routine maintenance, and integration-driven workflows.
-
-→ [Learn about cloud agents](/platform/)
-
----
-
-## How they work together
-
-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.
-
----
-
-## Multi-model support
-
-Oz is multi-model by design. You can [choose your preferred LLM](/agent-platform/inference/model-choice/) from a curated set of top models.
-
----
-
-## Open source
-
-Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/master/LICENSE-AGPL). The source lives at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), where you can read the code, file issues, and contribute alongside the Warp team. Development happens in the open with an agent-first workflow managed by Oz.
-
-→ [Contributing to Warp](/support-and-community/community/contributing/) explains how to file issues, claim work, and ship code or themes.
-
----
-
-## Privacy and security
-
-Warp is **SOC 2 compliant** and has **Zero Data Retention** policies with all contracted LLM providers. No customer AI data is retained, stored, or used for training.
-
-Warp's AI features can be globally disabled in **Settings** > **Agents** > **Warp Agent**.
-
-→ [Read more about data privacy](https://www.warp.dev/privacy)
-
----
-
-## 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
diff --git a/src/content/docs/terminal/index.mdx b/src/content/docs/terminal/index.mdx
new file mode 100644
index 000000000..3957ce6af
--- /dev/null
+++ b/src/content/docs/terminal/index.mdx
@@ -0,0 +1,18 @@
+---
+title: Getting started with Warp Terminal
+description: >-
+ Get started with Warp, a fast, modern terminal built for coding. Learn the
+ key features and how to set up your environment.
+sidebar:
+ label: Getting started with Warp
+---
+
+Warp is a modern, high-performance terminal built for coding. This section covers the key features of the Warp terminal and how to get set up.
+
+import { CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+
+
+
+
+
diff --git a/src/sidebar.ts b/src/sidebar.ts
index 1394d88c7..55435e757 100644
--- a/src/sidebar.ts
+++ b/src/sidebar.ts
@@ -17,15 +17,139 @@ import type { StarlightSidebarTopicsUserConfig } from 'starlight-sidebar-topics'
* navigation structure.
*/
export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
+ {
+ label: 'Automation Platform',
+ link: '/platform/',
+ icon: 'cloud-download',
+ items: [
+ { slug: 'platform', label: 'Warp overview' },
+ {
+ label: 'Software Factory',
+ items: [
+ { slug: 'platform/software-factory', label: 'Overview' },
+ { slug: 'guides/agent-workflows/set-up-a-software-factory', label: 'Set up your factory' },
+ { slug: 'guides/agent-workflows/build-a-triage-agent', label: 'Factory agent roles' },
+ { slug: 'guides/agent-workflows/build-a-self-improving-agent', label: 'Self-improving factories' },
+ ],
+ },
+ {
+ label: 'Automation Platform',
+ items: [
+ { slug: 'platform/overview', label: 'Automation Platform overview' },
+ { slug: 'platform/quickstart', label: 'Quickstart' },
+ ],
+ },
+ {
+ label: 'Integrations & Triggers',
+ items: [
+ { slug: 'platform/integrations', label: 'Overview' },
+ { slug: 'platform/integrations/quickstart', label: 'Quickstart' },
+ 'platform/integrations/slack',
+ 'platform/integrations/linear',
+ 'platform/integrations/jira',
+ {
+ label: 'GitHub Actions',
+ collapsed: true,
+ items: [
+ { slug: 'platform/integrations/github-actions', label: 'Overview' },
+ { slug: 'platform/integrations/quickstart-github-actions', label: 'Quickstart' },
+ ],
+ },
+ 'platform/integrations/azure-devops',
+ 'platform/integrations/bitbucket',
+ 'platform/integrations/gitlab',
+ { slug: 'platform/integrations/cloud-providers', label: 'AWS, GCP, and other cloud providers' },
+ { slug: 'platform/triggers', label: 'Scheduled triggers' },
+ { slug: 'platform/triggers/scheduled-agents-quickstart', label: 'Scheduled trigger quickstart' },
+ { slug: 'platform/triggers/scheduled-agents', label: 'Scheduled agents' },
+ ],
+ },
+ {
+ label: 'Managing agents',
+ items: [
+ 'platform/environments',
+ { slug: 'platform/runners', label: 'Runners' },
+ { slug: 'platform/managing-cloud-agents', label: 'Managing cloud agents' },
+ { slug: 'platform/agents', label: 'Agents' },
+ { slug: 'platform/viewing-cloud-agent-runs', label: 'Viewing cloud agent runs' },
+ { slug: 'platform/oz-web-app', label: 'Warp web app' },
+ ],
+ },
+ {
+ label: 'Orchestration',
+ items: [
+ { slug: 'platform/orchestration', label: 'Multi-agent orchestration' },
+ { slug: 'platform/orchestration/multi-agent-runs', label: 'Running orchestrated agents' },
+ ],
+ },
+ {
+ label: 'Handoff',
+ items: [
+ { slug: 'platform/handoff', label: 'Overview' },
+ { slug: 'platform/handoff/local-to-cloud', label: 'Local to cloud' },
+ { slug: 'platform/handoff/cloud-to-cloud', label: 'Cloud to cloud' },
+ { slug: 'platform/handoff/snapshots', label: 'Snapshots' },
+ ],
+ },
+ {
+ label: 'Harnesses',
+ items: [
+ { slug: 'platform/harnesses', label: 'Overview' },
+ { slug: 'platform/harnesses/warp-agent', label: 'Warp Agent' },
+ { slug: 'platform/harnesses/claude-code', label: 'Claude Code' },
+ { slug: 'platform/harnesses/codex', label: 'Codex' },
+ { slug: 'platform/harnesses/authentication', label: 'Authentication' },
+ ],
+ },
+ {
+ label: 'Extending agents',
+ items: [
+ { slug: 'platform/skills-as-agents', label: 'Skills as agents' },
+ { slug: 'platform/mcp', label: 'MCP servers' },
+ 'platform/secrets',
+ ],
+ },
+ {
+ label: 'Deployment & hosting',
+ items: [
+ { slug: 'platform/deployment-patterns', label: 'Deployment patterns' },
+ { slug: 'platform/warp-hosting', label: 'Warp-hosted agents' },
+ {
+ label: 'Self-hosting',
+ collapsed: true,
+ items: [
+ { slug: 'platform/self-hosting', label: 'Overview' },
+ { slug: 'platform/self-hosting/quickstart', label: 'Quickstart' },
+ { slug: 'platform/self-hosting/managed-docker', label: 'Managed: Docker' },
+ { slug: 'platform/self-hosting/managed-kubernetes', label: 'Managed: Kubernetes' },
+ { slug: 'platform/self-hosting/managed-direct', label: 'Managed: Direct' },
+ { slug: 'platform/self-hosting/unmanaged', label: 'Unmanaged' },
+ 'platform/self-hosting/monitoring',
+ { slug: 'platform/self-hosting/reference', label: 'Self-hosted worker reference' },
+ 'platform/self-hosting/security-and-networking',
+ { slug: 'platform/self-hosting/troubleshooting', label: 'Troubleshooting' },
+ ],
+ },
+ ],
+ },
+ {
+ label: 'Access & support',
+ items: [
+ { slug: 'platform/team-access-billing-and-identity', label: 'Access, billing, and identity' },
+ { slug: 'platform/faqs', label: 'Cloud agent FAQs' },
+ ],
+ },
+ ],
+ },
{
label: 'Terminal',
- link: '/',
+ link: '/terminal/',
icon: 'laptop',
items: [
{
label: 'Getting started',
items: [
- { label: 'Getting started with Warp and Oz', link: '/' },
+ { slug: 'terminal', label: 'Getting started with Warp' },
{ slug: 'quickstart', label: 'Warp quickstart' },
'getting-started/quickstart/installation-and-setup',
'getting-started/quickstart/coding-in-warp',
@@ -251,6 +375,14 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
label: 'Warp Agents',
items: [
{ slug: 'agent-platform/local-agents/overview', label: 'Warp Agents overview' },
+ {
+ label: 'Warp Agent CLI',
+ collapsed: false,
+ items: [
+ { slug: 'agent-platform/warp-tui/overview', label: 'Overview' },
+ { slug: 'agent-platform/warp-tui/getting-started', label: 'Getting started' },
+ ],
+ },
{
label: 'Capabilities',
collapsed: true,
@@ -332,127 +464,6 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
},
],
},
- {
- label: 'Oz',
- link: '/platform/',
- icon: 'cloud-download',
- items: [
- { slug: 'platform', label: 'Cloud agents overview' },
- {
- label: 'Getting started',
- items: [
- { slug: 'platform/quickstart', label: 'Quickstart' },
- { slug: 'platform/overview', label: 'Oz platform' },
- ],
- },
- {
- label: 'Triggers',
- items: [
- { slug: 'platform/triggers', label: 'Overview' },
- { slug: 'platform/triggers/scheduled-agents-quickstart', label: 'Quickstart' },
- { slug: 'platform/triggers/scheduled-agents', label: 'Scheduled agents' },
- ],
- },
- {
- label: 'Integrations',
- items: [
- { slug: 'platform/integrations', label: 'Overview' },
- { slug: 'platform/integrations/quickstart', label: 'Quickstart' },
- 'platform/integrations/slack',
- 'platform/integrations/linear',
- 'platform/integrations/jira',
- {
- label: 'GitHub Actions',
- collapsed: true,
- items: [
- { slug: 'platform/integrations/github-actions', label: 'Overview' },
- { slug: 'platform/integrations/quickstart-github-actions', label: 'Quickstart' },
- ],
- },
- 'platform/integrations/azure-devops',
- 'platform/integrations/bitbucket',
- 'platform/integrations/gitlab',
- { slug: 'platform/integrations/cloud-providers', label: 'AWS, GCP, and other cloud providers' },
- ],
- },
- {
- label: 'Managing agents',
- items: [
- 'platform/environments',
- { slug: 'platform/runners', label: 'Runners' },
- { slug: 'platform/managing-cloud-agents', label: 'Managing cloud agents' },
- { slug: 'platform/agents', label: 'Agents' },
- { slug: 'platform/viewing-cloud-agent-runs', label: 'Viewing cloud agent runs' },
- { slug: 'platform/oz-web-app', label: 'Oz web app' },
- ],
- },
- {
- label: 'Orchestration',
- items: [
- { slug: 'platform/orchestration', label: 'Multi-agent orchestration' },
- { slug: 'platform/orchestration/multi-agent-runs', label: 'Running orchestrated agents' },
- { slug: 'platform/software-factory', label: 'Software factory' },
- ],
- },
- {
- label: 'Handoff',
- items: [
- { slug: 'platform/handoff', label: 'Overview' },
- { slug: 'platform/handoff/local-to-cloud', label: 'Local to cloud' },
- { slug: 'platform/handoff/cloud-to-cloud', label: 'Cloud to cloud' },
- { slug: 'platform/handoff/snapshots', label: 'Snapshots' },
- ],
- },
- {
- label: 'Harnesses',
- items: [
- { slug: 'platform/harnesses', label: 'Overview' },
- { slug: 'platform/harnesses/warp-agent', label: 'Warp Agent' },
- { slug: 'platform/harnesses/claude-code', label: 'Claude Code' },
- { slug: 'platform/harnesses/codex', label: 'Codex' },
- { slug: 'platform/harnesses/authentication', label: 'Authentication' },
- ],
- },
- {
- label: 'Extending agents',
- items: [
- { slug: 'platform/skills-as-agents', label: 'Skills as agents' },
- { slug: 'platform/mcp', label: 'MCP servers' },
- 'platform/secrets',
- ],
- },
- {
- label: 'Deployment & hosting',
- items: [
- { slug: 'platform/deployment-patterns', label: 'Deployment patterns' },
- { slug: 'platform/warp-hosting', label: 'Warp-hosted agents' },
- {
- label: 'Self-hosting',
- collapsed: true,
- items: [
- { slug: 'platform/self-hosting', label: 'Overview' },
- { slug: 'platform/self-hosting/quickstart', label: 'Quickstart' },
- { slug: 'platform/self-hosting/managed-docker', label: 'Managed: Docker' },
- { slug: 'platform/self-hosting/managed-kubernetes', label: 'Managed: Kubernetes' },
- { slug: 'platform/self-hosting/managed-direct', label: 'Managed: Direct' },
- { slug: 'platform/self-hosting/unmanaged', label: 'Unmanaged' },
- 'platform/self-hosting/monitoring',
- { slug: 'platform/self-hosting/reference', label: 'Self-hosted worker reference' },
- 'platform/self-hosting/security-and-networking',
- { slug: 'platform/self-hosting/troubleshooting', label: 'Troubleshooting' },
- ],
- },
- ],
- },
- {
- label: 'Access & support',
- items: [
- { slug: 'platform/team-access-billing-and-identity', label: 'Access, billing, and identity' },
- { slug: 'platform/faqs', label: 'Cloud agent FAQs' },
- ],
- },
- ],
- },
{
label: 'Reference',
link: '/reference/',
diff --git a/vercel.json b/vercel.json
index d8e4447c6..da88ae751 100644
--- a/vercel.json
+++ b/vercel.json
@@ -95,6 +95,11 @@
}
],
"redirects": [
+ {
+ "source": "/",
+ "destination": "/platform/",
+ "statusCode": 302
+ },
{
"source": "/terminal",
"destination": "/terminal/input/classic-input/",