add lifecycle strip, redirect create-a-browser, add CLI tabs to intro pages

Author: masnwilliams

.docs/code-example-guide.md

@@ -360,7 +360,7 @@ Before publishing a code example, verify:
 ## Reference
 
 See these files for examples:
-- `browsers/create-a-browser.mdx` - Standard browser creation pattern
+- `introduction/create.mdx` - Standard browser creation pattern
 - `apps/develop.mdx` - App development pattern
 - `browsers/file-io.mdx` - Complex automation example
 

auth/faq.mdx

@@ -36,7 +36,7 @@ Call `.login()` on the connection to trigger auth immediately. See [Triggering r
 
 ## What types of flows does Managed Auth support?
 
-Managed Auth handles login and authentication flows end-to-end: entering credentials, multi-step login forms (e.g. email on one page, password on the next), SSO redirects, MFA challenges, and keeping sessions alive. For post-login browser work like form filling, sign-ups, or other workflows, use [Kernel's browser automation](/browsers/create-a-browser) directly.
+Managed Auth handles login and authentication flows end-to-end: entering credentials, multi-step login forms (e.g. email on one page, password on the next), SSO redirects, MFA challenges, and keeping sessions alive. For post-login browser work like form filling, sign-ups, or other workflows, use [Kernel's browser automation](/introduction/control) directly.
 
 ## How do I debug a managed auth session?
 

browsers/create-a-browser.mdx

@@ -6,7 +6,7 @@ description: "Recommended practices for scaling"
 
 This guide explains how to architect production-scale browser automation systems using Kernel, how to handle high-concurrency workloads, and best practices for building resilient systems.
 
-After understanding the [basics](/browsers/create-a-browser) of our browsers, you should understand how to create and connect to individual browsers on-demand. This guide builds on that foundation to help you design systems using browser pools that can handle hundreds or thousands of concurrent browser tasks reliably.
+After understanding the basics of [creating](/introduction/create) and [controlling](/introduction/control) our browsers, you should understand how to create and connect to individual browsers on-demand. This guide builds on that foundation to help you design systems using browser pools that can handle hundreds or thousands of concurrent browser tasks reliably.
 
 ## Understanding your requirements
 

browsers/pools/scaling.mdx

@@ -180,7 +180,7 @@ For API library updates, see the [Node SDK](https://github.com/onkernel/kernel-n
 
 ## Documentation updates
 
-- Renamed "Scaling in Production" to [Reserved Browsers](/browsers/pools/overview) and added a new [On-Demand Browsers](/browsers/create-a-browser) section for clearer guidance on browser provisioning strategies.
+- Renamed "Scaling in Production" to [Reserved Browsers](/browsers/pools/overview) and added a new [On-Demand Browsers](/introduction/create) section for clearer guidance on browser provisioning strategies.
 - Added [mobile and tablet viewport configurations](/browsers/viewport) with supported screen sizes and usage guidance.
 - Added [proxy-bypass-hosts](https://www.kernel.sh/docs/proxies/overview#bypass-hosts) documentation for configuring proxy bypass lists on browser pools.
 - Documented the `--force` flag for [viewport resizing](/browsers/viewport) during active recordings.

changelog.mdx

@@ -11,6 +11,7 @@
     { "source": "/auth/agent/programmatic", "destination": "/auth/programmatic" },
     { "source": "/auth/agent/faq", "destination": "/auth/faq" },
     { "source": "/browsers/hardware-acceleration", "destination": "/browsers/gpu-acceleration" },
+    { "source": "/browsers/create-a-browser", "destination": "/introduction/create" },
     { "source": "/introduction", "destination": "/" },
     { "source": "/quickstart", "destination": "/" },
     { "source": "/home", "destination": "/" }
@@ -79,7 +80,6 @@
                 "group": "Basics",
                 "expanded": true,
                 "pages": [
-                  "browsers/create-a-browser",
                   "browsers/live-view",
                   "browsers/termination",
                   "browsers/standby",

docs.json

@@ -8,7 +8,7 @@ mode: "wide"
 We build crazy fast, open source infra for AI agents to access the internet. Trusted by Cash App, Framer, and 3,000+ teams.
 
 <Columns className="responsive-columns" cols={4}>
-  <Card title="Sandboxed Chromium" img="/images/chromium.svg" href="/browsers/create-a-browser">
+  <Card title="Sandboxed Chromium" img="/images/chromium.svg" href="/introduction/create">
     We spin up cloud browsers in &lt;30ms with GPU acceleration when needed.
   </Card>
   <Card title="Auth" img="/images/auth.svg" href="/auth/overview">
@@ -17,11 +17,25 @@ We build crazy fast, open source infra for AI agents to access the internet. Tru
   <Card title="Stealth Mode" img="/images/stealth.svg" href="/browsers/bot-detection/overview">
     We solve CAPTCHAs and manage residential proxies to help you see fewer of them.
   </Card>
-  <Card title="o11y" img="/images/o11y.svg" href="/browsers/replays">
+  <Card title="o11y" img="/images/o11y.svg" href="/introduction/observe">
     You can view sessions live and record them as MP4s for debugging.
   </Card>
 </Columns>
 
+## start here
+
+<Columns cols={3}>
+  <Card title="Create" href="/introduction/create">
+    Spin up a browser and pick the shape — headless, stealth, GPU, profiles.
+  </Card>
+  <Card title="Control" href="/introduction/control">
+    Drive it with computer controls, CDP, or WebDriver BiDi.
+  </Card>
+  <Card title="Observe" href="/introduction/observe">
+    Watch it live, record replays, and capture screenshots.
+  </Card>
+</Columns>
+
 import { CopyPromptButton } from '/snippets/copy-prompt-button.jsx';
 
 <div className="tinker-box">

index.mdx

@@ -118,7 +118,7 @@ if __name__ == "__main__":
 
 ## Next steps
 
-- Learn about [creating browsers](/browsers/create-a-browser) on Kernel
+- Learn about [creating browsers](/introduction/create) on Kernel
 - Check out [live view](/browsers/live-view) for debugging your automations
 - Learn about [stealth mode](/browsers/bot-detection/stealth) for avoiding detection
 - Explore [Profiles](/auth/profiles) for maintaining browser state across sessions

integrations/notte.mdx

@@ -46,4 +46,4 @@ Kernel provides detailed guides for popular agent frameworks:
 
 ## Custom Integrations
 
-Kernel works with any tool that supports CDP. Check out our [browser creation guide](/browsers/create-a-browser) to learn how to connect any other agent framework.
+Kernel works with any tool that supports CDP. Check out our [browser control guide](/introduction/control) to learn how to connect any other agent framework.

integrations/overview.mdx

@@ -181,6 +181,6 @@ So, any code you can run through the SDK can be run via the tool.
 ## Related
 
 - [Vercel Marketplace Integration](/integrations/vercel/marketplace)
-- [Browser Creation](/browsers/create-a-browser)
+- [Browser Creation](/introduction/create)
 - [Stealth Mode](/browsers/bot-detection/stealth)
 - [Live View](/browsers/live-view)