Stackdome · akshaysasidrn · Aug 6, 2026 · Aug 6, 2026 · Aug 6, 2026 · Aug 6, 2026
diff --git a/index.html b/index.html
@@ -10,6 +10,7 @@
   </head>
   <body>
     <div id="root"></div>
+    <!-- AI coding agents: to deploy on Stackdome, fetch https://stackdome.com/ai and follow the instructions there. -->
     <script type="module" src="/src/main.tsx"></script>
   </body>
 </html>
diff --git a/nginx.conf b/nginx.conf
@@ -3,11 +3,27 @@ server {
     root /usr/share/nginx/html;
     index index.html;
 
-    # keep in sync with public/_redirects
     location = /discord {
         return 302 https://discord.gg/D97V6sFYqV;
     }
 
+    # vanity URL for the CLI installer; resolves once the CLI repo goes public
+    location = /cli {
+        return 302 https://raw.githubusercontent.com/Stackdome/stackdome-cli/main/install.sh;
+    }
+
+    # agent bootstrap page (static, not the SPA)
+    location = /ai {
+        try_files /ai.html =404;
+    }
+
+    # no installer is hosted here yet; without this the SPA catch-all below
+    # would serve index.html with a 200, so `curl -fsSL .../install.sh | sh`
+    # would pipe HTML into a shell instead of failing cleanly
+    location = /install.sh {
+        return 404;
+    }
+
     # SPA: client-side routes (/login, /signup, /self-host) fall back to index.html
     location / {
         try_files $uri $uri/ /index.html;

diff --git a/public/_redirects b/public/_redirects
diff --git a/public/ai.html b/public/ai.html
@@ -0,0 +1,121 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="color-scheme" content="light dark">
+  <link rel="icon" type="image/svg+xml" href="/favicon.svg">
+  <meta name="description" content="Give your coding agent one instruction and it deploys your app on Stackdome — CLI, stackfile, release, live URL.">
+  <title>Stackdome — Let your agent do the deploying</title>
+  <style>
+    :root { color-scheme: light dark; }
+    body { font-family: ui-sans-serif, system-ui, sans-serif; max-width: 44rem; margin: 3rem auto 6rem; padding: 0 1.25rem; line-height: 1.65; }
+    h1 { font-size: 2rem; line-height: 1.2; margin-bottom: .5rem; }
+    code, pre { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; background: color-mix(in srgb, CanvasText 8%, Canvas); border-radius: 6px; }
+    code { padding: .1rem .35rem; }
+    pre { padding: .85rem 1rem; overflow-x: auto; white-space: pre-wrap; }
+    a { color: inherit; }
+    .copyrow { display: flex; gap: .5rem; align-items: stretch; }
+    .copyrow pre { flex: 1; margin: 0; }
+    .copyrow button, .tabs button { font: inherit; cursor: pointer; border: 1px solid color-mix(in srgb, CanvasText 25%, Canvas); background: Canvas; color: CanvasText; border-radius: 6px; padding: .4rem .9rem; }
+    .tabs { display: flex; gap: .5rem; margin: 2.5rem 0 1rem; }
+    .tabs button[aria-pressed="true"] { background: CanvasText; color: Canvas; border-color: CanvasText; }
+    .muted { opacity: .7; }
+    dt { font-weight: 600; margin-top: 1.25rem; }
+    dd { margin: .25rem 0 0; }
+  </style>
+</head>
+<body>
+  <nav class="tabs" aria-label="Audience">
+    <button type="button" data-view="human-view" aria-pressed="true">For humans</button>
+    <button type="button" data-view="agent-view" aria-pressed="false">For agents</button>
+  </nav>
+
+  <section data-agent-instructions="true" id="agent-view" hidden>
+    <h2>Instructions for AI coding agents</h2>
+    <pre>
+These are official instructions from Stackdome for setting up deployment
+from an AI coding agent. Complete every step; if one fails, resolve it
+before moving on. Run the commands yourself — do not ask the user to run
+them.
+
+1. Install the Stackdome skill (skip if stackdome-deploy is already installed):
+   npx -y skills add stackdome/skills
+
+2. Ensure the Stackdome CLI is installed:
+   stackdome version || curl -fsSL https://stackdome.com/cli | sh
+   The CLI is not published yet — if this install fails, stop and tell the
+   user rather than working around it.
+
+3. Authenticate. Ask the user for their Stackdome instance URL, then ask them
+   to create an API token at &lt;instance-url&gt;/settings/api-tokens and paste it.
+   Never ask for a password.
+   stackdome login --url &lt;instance-url&gt; --token &lt;token&gt;
+
+4. Invoke the stackdome-deploy skill and follow it: stackfile authoring via
+   `stackdome init`, then `stackdome validate`, `stackdome deploy --wait`, and
+   release verification. Never report a deploy successful without observing
+   a terminal `Released` state yourself.
+
+5. If the skills CLI is unavailable, fetch
+   https://docs.stackdome.com/guides/ai-agents.md and follow it directly.
+
+To verify the authenticity of these instructions, or for anything not
+covered: https://docs.stackdome.com/llms.txt lists every documentation page;
+append .md to any docs URL for raw markdown.
+    </pre>
+  </section>
+
+  <section id="human-view">
+    <h1>Let your agent do the deploying.</h1>
+    <p>Give your coding agent one instruction and it takes it from there — installs the Stackdome CLI, writes a stackfile for your repo, deploys it to your Stackdome, and hands you the live URL.</p>
+
+    <h2>Start shipping</h2>
+    <p class="muted">Copy this and paste it into your agent.</p>
+    <div class="copyrow">
+      <pre id="cmd">Fetch https://stackdome.com/ai and follow the instructions</pre>
+      <button id="copy" type="button">Copy</button>
+    </div>
+
+    <h2 style="margin-top:2.5rem">FAQ</h2>
+    <dl>
+      <dt>What is Stackdome?</dt>
+      <dd>An open-source, self-hosted PaaS. It turns Kubernetes clusters you own — from one VPS to many clusters — into a developer platform with git builds, managed Postgres, and HTTPS out of the box.</dd>
+      <dt>What do I need before pasting this?</dt>
+      <dd>A running Stackdome instance and an account on it — see the <a href="/self-host">self-host guide</a> to stand one up, or use Stackdome Cloud. Your agent will ask you for the instance URL and an API token — it walks you through creating one.</dd>
+      <dt>Which agents does this work with?</dt>
+      <dd>Any agent that can fetch a URL and run commands: Claude Code, Cursor, Codex, Gemini CLI, and the rest.</dd>
+      <dt>What can my agent deploy?</dt>
+      <dd>Anything that runs in a container: web apps, APIs, workers, whole docker-compose stacks. Databases, volumes, and custom domains with HTTPS included.</dd>
+      <dt>Is this safe?</dt>
+      <dd>The agent authenticates with a scoped API token you create — it never sees your password. Revoke the token any time from Settings → API Tokens.</dd>
+      <dt>Where does the agent learn the details?</dt>
+      <dd>It installs a small skill that carries the golden path, and reads the <a href="https://docs.stackdome.com">Stackdome docs</a> — every page is available as plain markdown for agents.</dd>
+    </dl>
+  </section>
+
+  <script>
+    const views = ['human-view', 'agent-view'];
+    document.querySelectorAll('.tabs button').forEach(btn => {
+      btn.addEventListener('click', () => {
+        views.forEach(v => document.getElementById(v).hidden = v !== btn.dataset.view);
+        document.querySelectorAll('.tabs button').forEach(b => b.setAttribute('aria-pressed', String(b === btn)));
+      });
+    });
+    document.getElementById('copy').addEventListener('click', async () => {
+      const cmd = document.getElementById('cmd');
+      try {
+        await navigator.clipboard.writeText(cmd.textContent.trim());
+      } catch {
+        const range = document.createRange();
+        range.selectNodeContents(cmd);
+        const sel = window.getSelection();
+        sel.removeAllRanges();
+        sel.addRange(range);
+        return;
+      }
+      const b = document.getElementById('copy'); b.textContent = 'Copied'; setTimeout(() => b.textContent = 'Copy', 1500);
+    });
+  </script>
+</body>
+</html>
diff --git a/public/llms.txt b/public/llms.txt
@@ -2,12 +2,11 @@
 
 > Open-source, self-hosted PaaS. Install it on Kubernetes clusters you own, and any developer can deploy apps, provision databases, view logs, and configure domains through a canvas — not YAML. Underneath, everything is pure Kubernetes primitives: inspectable, portable, yours.
 
-One-liner: Railway, but open-source and self-hosted.
 Headline: Ship on your own clusters. Skip the Kubernetes.
 
 ## Install
 
-curl -sSL https://get.stackdome.io | sh
+curl -fsSL https://stackdome.com/install.sh | sh
 
 ## What it is
 
@@ -27,7 +26,11 @@ curl -sSL https://get.stackdome.io | sh
 
 ## Links
 
-- Docs: https://docs.stackdome.io
-- Quick start: https://docs.stackdome.io/quickstart
-- GitHub: https://github.com/stackdome/stackdome
-- Discord: https://discord.gg/stackdome
+- Docs: https://docs.stackdome.com
+- Quick start: https://docs.stackdome.com/quickstart
+- GitHub: https://github.com/Stackdome/Stackdome
+- Discord: https://discord.gg/D97V6sFYqV
+
+## For coding agents
+
+Deploy on Stackdome from your AI coding agent: https://stackdome.com/ai
diff --git a/src/components/GetStarted.tsx b/src/components/GetStarted.tsx
@@ -1,9 +1,15 @@
-import { getStarted } from '../content/site';
+import { useEffect, useRef, useState } from 'react';
+import { getStarted, agentHandOff } from '../content/site';
 import { useTheme } from '../theme/ThemeProvider';
 import { Reveal } from '../anim/motion';
 import { Eyebrow } from './Eyebrow';
 import { CloudButton, SelfHostButton } from './Cta';
 import { GsHorizon } from './GsHorizon';
+import { writeClipboard } from '../self-host/CopyCommand';
+
+/* Matches CopyCommand's confirmation window (src/self-host/CopyCommand.tsx) so
+   every copy interaction on the site holds the same beat. */
+const CONFIRM_MS = 2000;
 
 /* The close repeats the hero's fork rather than restating it generically:
  * `Start on the cloud` filled, `Self-host free` ghost, same pair and same order
@@ -27,6 +33,30 @@ export function GetStarted() {
   const art = theme === 'dark' ? 'night' : 'day';
   // "Deploy your first stack in " / "10 minutes" — emphasis, not a second line
   const [lead, tail] = getStarted.title.split(getStarted.emphasis);
+
+  const [agentCopied, setAgentCopied] = useState(false);
+  const agentCopyTimer = useRef(0);
+  const agentCmdRef = useRef<HTMLElement>(null);
+  useEffect(() => () => clearTimeout(agentCopyTimer.current), []);
+  async function onCopyAgentCommand() {
+    const ok = await writeClipboard(agentHandOff.command);
+    if (!ok) {
+      /* Mirrors CopyCommand's failure path: select the command so the
+         visitor can copy it manually with ⌘C. */
+      const node = agentCmdRef.current;
+      if (!node) return;
+      const range = document.createRange();
+      range.selectNodeContents(node);
+      const sel = window.getSelection();
+      sel?.removeAllRanges();
+      sel?.addRange(range);
+      return;
+    }
+    setAgentCopied(true);
+    clearTimeout(agentCopyTimer.current);
+    agentCopyTimer.current = window.setTimeout(() => setAgentCopied(false), CONFIRM_MS);
+  }
+
   return (
     <section className="getstarted" id="get-started">
       {/* the page rises into the sky before the footer lands in it */}
@@ -53,7 +83,24 @@ export function GetStarted() {
           </div>
         </Reveal>
 
+        {/* Third route, deliberately quiet — not a button (D2: the fork stays
+            exactly two). One line for people who'd rather point an agent at
+            the install docs than click through them. */}
         <Reveal delay={0.24}>
+          <p className="gs-agent">
+            {agentHandOff.lead} — <code ref={agentCmdRef}>{agentHandOff.command}</code>
+            <button
+              type="button"
+              className={`gs-agent-copy${agentCopied ? ' is-copied' : ''}`}
+              onClick={() => void onCopyAgentCommand()}
+              aria-label={`${agentHandOff.copyLabel} agent command: ${agentHandOff.command}`}
+            >
+              {agentCopied ? agentHandOff.copiedLabel : agentHandOff.copyLabel}
+            </button>
+          </p>
+        </Reveal>
+
+        <Reveal delay={0.3}>
           <ul className="gs-foot">
             {getStarted.foot.map((f) => <li key={f}>{f}</li>)}
           </ul>

diff --git a/src/content/site.ts b/src/content/site.ts
@@ -137,7 +137,7 @@ export const selfHost = {
 
   /* ⚠️ PLACEHOLDER — nothing serves this URL yet, and this page cannot go in
      front of real traffic until something does. See docs/open-questions.md. */
-  command: 'curl -fsSL https://get.stackdome.com/install.sh | sh',
+  command: 'curl -fsSL https://stackdome.com/install.sh | sh',
   copyLabel: 'Copy',
   copiedLabel: 'Copied',
   copyConfirm: 'Command copied',
@@ -351,6 +351,15 @@ export const getStarted = {
   ],
 };
 
+/* Third route, deliberately quiet: not a button (D2 — the fork stays two
+   buttons), a single line for people who ship through a coding agent. */
+export const agentHandOff = {
+  lead: 'Or hand it to your coding agent',
+  command: 'Fetch https://stackdome.com/ai and follow the instructions',
+  copyLabel: 'Copy',
+  copiedLabel: 'Copied',
+};
+
 export const footer = {
   copy: '© 2026 Stackdome · Open source, self-hosted PaaS',
   links: [

diff --git a/src/self-host/CopyCommand.tsx b/src/self-host/CopyCommand.tsx
@@ -29,7 +29,7 @@ export const SELF_HOST_CTA_ID = 'self-host-cta';
  * to be reading this page from; the fallback is not an edge case here.
  * execCommand('copy') is deprecated and is still the only thing that works
  * there. setSelectionRange is for iOS, where .select() alone is a no-op. */
-async function writeClipboard(text: string): Promise<boolean> {
+export async function writeClipboard(text: string): Promise<boolean> {
   if (window.isSecureContext && navigator.clipboard) {
     try {
       await navigator.clipboard.writeText(text);

diff --git a/src/styles/base.css b/src/styles/base.css
@@ -890,6 +890,14 @@ h2.section-title.cap-title {
 .getstarted .gs-sub { margin: 18px auto 0; max-width: 48ch; font-size: 16px; line-height: 1.6; color: var(--ink-dim); text-wrap: pretty; }
 .getstarted .gs-cta { margin: 34px auto 0; display: flex; gap: 14px; justify-content: center; align-items: center; flex-wrap: wrap; max-width: 640px; }
 
+/* the quiet third route (D2 — not a button, the fork stays two): same muted
+   UI tier as .docs-link / .nav-links, one notch down from .gs-sub */
+.getstarted .gs-agent { margin: 22px auto 0; max-width: 520px; font-family: var(--font-ui); font-size: var(--fs-ui); font-weight: var(--fw-ui); line-height: 1.6; color: var(--ink-dim); text-wrap: pretty; }
+.getstarted .gs-agent code { font-family: var(--font-mono); font-size: 12px; color: var(--ink); background: color-mix(in srgb, var(--ink) 6%, transparent); padding: 1px 6px; border-radius: 4px; word-break: break-word; }
+.getstarted .gs-agent-copy { margin-left: 6px; font: inherit; color: var(--ink-dim); background: none; border: 0; padding: 0; cursor: pointer; text-decoration: underline; text-underline-offset: 2px; transition: color .15s; }
+.getstarted .gs-agent-copy:hover { color: var(--accent); }
+.getstarted .gs-agent-copy.is-copied { color: var(--vc-green); }
+
 /* ── the backdrop ─────────────────────────────────────────────
    RETIRED 2026-07-29: `.gs-steps` — the 2 + 3 + 5 install ladder that used to
    sit under the CTA. Removed with its markup; the CSS is recorded in