docs: one name per page, clean sidebar links, a compact llms-small.txt

README.md

@@ -94,7 +94,7 @@ Refs are valid only in the latest output: after a `--settle` command, use the re
 }
 ```
 
-See [AI Agent Setup](https://agent-device.dev/docs/agent-setup) for per-client setup and when to prefer plain CLI over MCP.
+See [AI agent setup](https://agent-device.dev/docs/agent-setup) for per-client setup and when to prefer plain CLI over MCP.
 
 ### Script it from Node.js
 
@@ -139,9 +139,9 @@ With the CLI installed, prompts like these work end to end:
 
 ## Next steps
 
-- [AI Agent Setup](https://agent-device.dev/docs/agent-setup): skills, project rules, and per-client setup for Cursor, Codex, Claude Code, Windsurf, and others.
-- [Quick Start](https://agent-device.dev/docs/quick-start): open an app, read its UI, and interact with it from the command line.
-- [Replay & E2E](https://agent-device.dev/docs/replay-e2e) and [Debugging & Profiling](https://agent-device.dev/docs/debugging-profiling): repeatable tests and bug hunting.
+- [AI agent setup](https://agent-device.dev/docs/agent-setup): skills, project rules, and per-client setup for Cursor, Codex, Claude Code, Windsurf, and others.
+- [Quick start](https://agent-device.dev/docs/quick-start): open an app, read its UI, and interact with it from the command line.
+- [Replay and E2E testing](https://agent-device.dev/docs/replay-e2e) and [Debugging and profiling](https://agent-device.dev/docs/debugging-profiling): repeatable tests and bug hunting.
 
 ## Where to run agent-device
 
@@ -171,7 +171,7 @@ Sessions are scoped to the caller's git worktree, and host-local device claims s
 
 ### Is there an MCP server for mobile app automation?
 
-Yes. `agent-device mcp` starts the official stdio MCP server. The Quick start above has the client config, and [AI Agent Setup](https://agent-device.dev/docs/agent-setup) covers per-client details.
+Yes. `agent-device mcp` starts the official stdio MCP server. The Quick start above has the client config, and [AI agent setup](https://agent-device.dev/docs/agent-setup) covers per-client details.
 
 ### Does it work with React Native, Expo, Flutter, and native apps?
 

website/astro.config.mjs

@@ -7,16 +7,21 @@ import starlightLlmsTxt from 'starlight-llms-txt';
 import { brandCss } from './src/site/brand.ts';
 import { site as meta, noindexPaths } from './src/site/content.ts';
 import { TITLE_DELIMITER } from './src/site/meta.ts';
-import { llmsDescription, llmsDetails, llmsOptionalLinks } from './src/site/llms.ts';
+import {
+  llmsDescription,
+  llmsDetails,
+  llmsOptionalLinks,
+  llmsSmallExclude,
+} from './src/site/llms.ts';
 
 const site = meta.url;
 const repo = meta.repo;
 const description = meta.description;
 // Where this site lives inside the repo, for the docs' "Edit page" links.
 const siteDir = 'website';
 
-const doc = (name, label) => ({ label, slug: `docs/${name}` });
-const group = (label, items) => ({ label, items: items.map(([name, text]) => doc(name, text)) });
+// Sidebar entries take the page's own title, so a page has one name everywhere.
+const group = (label, names) => ({ label, items: names.map((name) => `docs/${name}`) });
 
 export default defineConfig({
   site,
@@ -79,48 +84,47 @@ export default defineConfig({
       ],
       sidebar: [
         group('Getting started', [
-          ['introduction', 'Introduction'],
-          ['installation', 'Installation'],
-          ['plugins', 'Provider plugins'],
-          ['agent-setup', 'AI agent setup'],
-          ['quick-start', 'Quick start'],
+          'introduction',
+          'installation',
+          'plugins',
+          'agent-setup',
+          'quick-start',
         ]),
         group('Usage', [
-          ['capabilities', 'Capabilities'],
-          ['commands', 'Commands'],
-          ['configuration', 'Configuration'],
-          ['selectors', 'Selectors'],
-          ['sessions', 'Sessions'],
-          ['batching', 'Batching'],
-          ['snapshots', 'Snapshots'],
-          ['replay-e2e', 'Replay and E2E testing'],
-          ['run-maestro-flows', 'Run Maestro flows'],
-          ['debugging-profiling', 'Debugging and profiling'],
+          'capabilities',
+          'commands',
+          'configuration',
+          'selectors',
+          'sessions',
+          'batching',
+          'snapshots',
+          'replay-e2e',
+          'run-maestro-flows',
+          'debugging-profiling',
         ]),
         group('Integrations', [
-          ['client-api', 'Node.js API'],
-          ['build-an-integration', 'Build an integration'],
-          ['ai-sdk', 'AI SDK'],
-          ['eve', 'Eve'],
-          ['remote-proxy', 'Remote proxy'],
-          ['device-clouds', 'Device clouds'],
-          ['browserstack', 'BrowserStack'],
-          ['aws-device-farm', 'AWS Device Farm'],
-          ['testmu', 'TestMu AI'],
-          ['limrun', 'Limrun'],
-        ]),
-        group('Reference', [
-          ['security-trust', 'Security and trust'],
-          ['known-limitations', 'Known limitations'],
-          ['migrating-gestures', 'Rewrite old gesture commands'],
+          'client-api',
+          'build-an-integration',
+          'ai-sdk',
+          'eve',
+          'remote-proxy',
+          'device-clouds',
+          'browserstack',
+          'aws-device-farm',
+          'testmu',
+          'limrun',
         ]),
+        group('Reference', ['security-trust', 'known-limitations', 'migrating-gestures']),
       ],
       plugins: [
         starlightLlmsTxt({
           projectName: meta.name,
           description: llmsDescription,
           details: llmsDetails,
           optionalLinks: llmsOptionalLinks,
+          // llms-small.txt leaves out the reference pages in llmsSmallExclude (their tables also
+          // flatten badly there); llms-full.txt keeps every page.
+          exclude: llmsSmallExclude.map((slug) => `docs/${slug}`),
         }),
       ],
     }),

website/docs/docs/agent-setup.md

@@ -1,5 +1,5 @@
 ---
-title: AI Agent Setup
+title: AI agent setup
 description: Configure Cursor, Codex, Claude Code, Windsurf, Cline, Goose, iOS Simulator and Android Emulator skills, and MCP for agent-device app verification.
 ---
 
@@ -241,7 +241,7 @@ If the client supports project rules or custom instructions, paste the [recommen
 
 For supported targets, evidence features, and how `agent-device` differs from scripted test frameworks, see [Introduction](/docs/introduction). For command groups and platform behavior, see [Commands](/docs/commands).
 
-For the local execution model, permissions, artifacts, and sensitive data guidance, see [Security & Trust](/docs/security-trust).
+For the local execution model, permissions, artifacts, and sensitive data guidance, see [Security and trust](/docs/security-trust).
 
 ## Agent-readable docs