From 480d16879ff6b6e521f0f3fa99aa87028cfff27f Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Fri, 24 Jul 2026 17:58:41 -0600 Subject: [PATCH 1/8] feat(ia-prototype): restructure nav for Factories launch MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Rename 'Oz' tab → 'Automation Platform', move to first position - Add Software Factory section as primary group in Automation Platform tab - Restructure platform sidebar: SF first, then Automation Platform, primitives below - Rename 'Oz web app' → 'Warp web app' in sidebar label - Remove software-factory from Orchestration group (now its own top-level section) - Add Warp TUI subsection under Agents > Warp Agents with stub pages Phase 0 (agent-platform → agents slug rename) intentionally deferred. Content rewrites (platform/index.mdx, etc.) deferred to Phase 2. Co-Authored-By: Oz --- .../warp-tui/getting-started.mdx | 32 +++ .../docs/agent-platform/warp-tui/overview.mdx | 26 ++ src/sidebar.ts | 258 ++++++++++-------- 3 files changed, 195 insertions(+), 121 deletions(-) create mode 100644 src/content/docs/agent-platform/warp-tui/getting-started.mdx create mode 100644 src/content/docs/agent-platform/warp-tui/overview.mdx 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 00000000..86814d53 --- /dev/null +++ b/src/content/docs/agent-platform/warp-tui/getting-started.mdx @@ -0,0 +1,32 @@ +--- +title: Getting started with Warp TUI +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 00000000..c612c1d4 --- /dev/null +++ b/src/content/docs/agent-platform/warp-tui/overview.mdx @@ -0,0 +1,26 @@ +--- +title: Warp TUI +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/sidebar.ts b/src/sidebar.ts index 1394d88c..b2ab24db 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -17,6 +17,135 @@ 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: '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: '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: '/', @@ -251,6 +380,14 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ label: 'Warp Agents', items: [ { slug: 'agent-platform/local-agents/overview', label: 'Warp Agents overview' }, + { + label: 'Warp TUI', + 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 +469,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/', From 1e4fbc8fbce16a92e5816a0fdeab371b97cfce20 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Fri, 24 Jul 2026 18:12:13 -0600 Subject: [PATCH 2/8] fix: redirect / to /platform/ so root URL lands on Automation Platform tab Co-Authored-By: Oz --- vercel.json | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/vercel.json b/vercel.json index d8e4447c..da88ae75 100644 --- a/vercel.json +++ b/vercel.json @@ -95,6 +95,11 @@ } ], "redirects": [ + { + "source": "/", + "destination": "/platform/", + "statusCode": 302 + }, { "source": "/terminal", "destination": "/terminal/input/classic-input/", From d3f3536cae75188e804e8242b021f2227e12abf5 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Sun, 26 Jul 2026 11:22:19 -0600 Subject: [PATCH 3/8] fix: point Terminal tab link to /quickstart/ instead of / (which now redirects to /platform/) Co-Authored-By: Oz --- src/sidebar.ts | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/sidebar.ts b/src/sidebar.ts index b2ab24db..eeb527ea 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -148,13 +148,12 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ }, { label: 'Terminal', - link: '/', + link: '/quickstart/', icon: 'laptop', items: [ { label: 'Getting started', items: [ - { label: 'Getting started with Warp and Oz', link: '/' }, { slug: 'quickstart', label: 'Warp quickstart' }, 'getting-started/quickstart/installation-and-setup', 'getting-started/quickstart/coding-in-warp', From cd3769ecdc7bea8e43784e2d61bfb8bf914368e8 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Sun, 26 Jul 2026 11:27:07 -0600 Subject: [PATCH 4/8] =?UTF-8?q?fix:=20revert=20Terminal=20link=20to=20/=20?= =?UTF-8?q?=E2=80=94=20plugin=20requires=20it=20as=20URL-prefix=20catch-al?= =?UTF-8?q?l?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit starlight-sidebar-topics assigns pages to topics by matching the page URL against each topic's link prefix. With link: '/quickstart/', the root index.mdx (URL: /) had no matching topic prefix, crashing the build. Prototype limitation: clicking the Terminal tab pill navigates to / which the Vercel redirect sends to /platform/. Terminal content is still fully reachable via sidebar items. This is inherent to having both a redirect from / and a plugin that uses / as Terminal's catch-all prefix. Co-Authored-By: Oz --- src/sidebar.ts | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/sidebar.ts b/src/sidebar.ts index eeb527ea..e74f9cee 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -148,12 +148,13 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ }, { label: 'Terminal', - link: '/quickstart/', + link: '/', icon: 'laptop', items: [ { label: 'Getting started', items: [ + { label: 'Getting started with Warp', link: '/' }, { slug: 'quickstart', label: 'Warp quickstart' }, 'getting-started/quickstart/installation-and-setup', 'getting-started/quickstart/coding-in-warp', From 19f56e0f8ad0ab4cd68cc3fbc54876896acfe059 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Sun, 26 Jul 2026 11:34:37 -0600 Subject: [PATCH 5/8] fix: create terminal/index.mdx, delete root index.mdx, set Terminal link to /terminal/ MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The starlight-sidebar-topics plugin requires every page in the content collection to be owned by a topic. As long as index.mdx existed at /, the Terminal tab could not use link: '/terminal/' without the plugin erroring on the unowned root page. Fix: delete index.mdx (planned in Phase 2 anyway) → Terminal tab can now correctly use link: '/terminal/', giving the tab pill proper destination. The / → /platform/ Vercel redirect handles any direct URL visits to root. Also creates terminal/index.mdx as a proper Terminal getting-started stub — matching the Phase 2 plan exactly. Note: quickstart, getting-started, code, and knowledge-and-collaboration pages still live under their own URL prefixes (not /terminal/*) so the plugin still uses link: '/terminal/' to activate the Terminal topic for those pages via sidebar item matching, not URL prefix. This works because the plugin checks items membership for non-prefixed pages. Co-Authored-By: Oz --- src/content/docs/index.mdx | 109 ---------------------------- src/content/docs/terminal/index.mdx | 18 +++++ src/sidebar.ts | 4 +- 3 files changed, 20 insertions(+), 111 deletions(-) delete mode 100644 src/content/docs/index.mdx create mode 100644 src/content/docs/terminal/index.mdx diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx deleted file mode 100644 index d505a68a..00000000 --- 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, the Agentic Development Environment: Warp (a modern terminal built for coding with agents) and Oz (the orchestration platform for cloud agents)](../../assets/terminal/warp-oz-welcome.png) -
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 00000000..3957ce6a --- /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 e74f9cee..d60ccb20 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -148,13 +148,13 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ }, { label: 'Terminal', - link: '/', + link: '/terminal/', icon: 'laptop', items: [ { label: 'Getting started', items: [ - { label: 'Getting started with Warp', 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', From 3378b11c29f28760bfcdf7664a232f7e3d6c5906 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Sun, 26 Jul 2026 11:41:06 -0600 Subject: [PATCH 6/8] fix: update 404 page home link from / to /platform/ (root page deleted) Co-Authored-By: Oz --- src/content/docs/404.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/404.mdx b/src/content/docs/404.mdx index 6e76c037..406898f9 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/) From 9eb82ea4f831746bcb4695b54eb298d1cd6e129c Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Tue, 28 Jul 2026 12:58:35 -0600 Subject: [PATCH 7/8] feat(v1.1): merge Triggers + Integrations into 'Integrations & Triggers' Based on HYC feedback: integrations are often the surfaces that trigger agents, making them logically unified. Integrations items come first, scheduled trigger items follow within the same section. Co-Authored-By: Oz --- src/sidebar.ts | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/src/sidebar.ts b/src/sidebar.ts index d60ccb20..2d5fc95f 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -40,15 +40,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ ], }, { - 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', + label: 'Integrations & Triggers', items: [ { slug: 'platform/integrations', label: 'Overview' }, { slug: 'platform/integrations/quickstart', label: 'Quickstart' }, @@ -67,6 +59,9 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ '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' }, ], }, { From 2d76c63d7b39c769639fa1cb7a49a5719a47adee Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Wed, 29 Jul 2026 11:34:46 -0600 Subject: [PATCH 8/8] =?UTF-8?q?fix:=20rename=20Warp=20TUI=20=E2=86=92=20Wa?= =?UTF-8?q?rp=20Agent=20CLI=20(official=20product=20name=20confirmed)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Oz --- .../agent-platform/warp-tui/getting-started.mdx | 2 +- .../docs/agent-platform/warp-tui/overview.mdx | 2 +- src/sidebar.ts | 16 ++++++++-------- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/src/content/docs/agent-platform/warp-tui/getting-started.mdx b/src/content/docs/agent-platform/warp-tui/getting-started.mdx index 86814d53..a8457e76 100644 --- a/src/content/docs/agent-platform/warp-tui/getting-started.mdx +++ b/src/content/docs/agent-platform/warp-tui/getting-started.mdx @@ -1,5 +1,5 @@ --- -title: Getting started with Warp TUI +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. diff --git a/src/content/docs/agent-platform/warp-tui/overview.mdx b/src/content/docs/agent-platform/warp-tui/overview.mdx index c612c1d4..1f853f79 100644 --- a/src/content/docs/agent-platform/warp-tui/overview.mdx +++ b/src/content/docs/agent-platform/warp-tui/overview.mdx @@ -1,5 +1,5 @@ --- -title: Warp TUI +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. diff --git a/src/sidebar.ts b/src/sidebar.ts index 2d5fc95f..55435e75 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -375,14 +375,14 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ label: 'Warp Agents', items: [ { slug: 'agent-platform/local-agents/overview', label: 'Warp Agents overview' }, - { - label: 'Warp TUI', - collapsed: false, - items: [ - { slug: 'agent-platform/warp-tui/overview', label: 'Overview' }, - { slug: 'agent-platform/warp-tui/getting-started', label: 'Getting started' }, - ], - }, + { + 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,