docs: add hubs index and clawdibuted

docs/docs.json

@@ -26,6 +26,7 @@
         "group": "Getting Started",
         "pages": [
           "index",
+          "hubs",
           "onboarding",
           "clawd",
           "faq"

docs/hubs.md

@@ -0,0 +1,158 @@
+---
+summary: "Hubs that link to every Clawdbot doc"
+read_when:
+  - You want a complete map of the documentation
+---
+# Docs hubs
+
+Use these hubs to discover every page, including deep dives and reference docs that don’t appear in the left nav.
+
+## Start here
+
+- [Index](./index.md)
+- [Onboarding](./onboarding.md)
+- [Wizard](./wizard.md)
+- [Setup](./setup.md)
+- [FAQ](./faq.md)
+- [Configuration](./configuration.md)
+- [Clawd (personal assistant)](./clawd.md)
+- [Lore](./lore.md)
+
+## Installation + distribution
+
+- [Docker](./docker.md)
+- [Nix](./nix.md)
+
+## Core concepts
+
+- [Architecture](./architecture.md)
+- [Agent runtime](./agent.md)
+- [Agent loop](./agent-loop.md)
+- [Sessions](./session.md)
+- [Sessions (alias)](./sessions.md)
+- [Session tools](./session-tool.md)
+- [Queue](./queue.md)
+- [RPC adapters](./rpc.md)
+- [TypeBox schemas](./typebox.md)
+- [Presence](./presence.md)
+- [Discovery + transports](./discovery.md)
+- [Bonjour](./bonjour.md)
+- [Surface routing](./surface.md)
+- [Groups](./groups.md)
+- [Group messages](./group-messages.md)
+
+## Providers + ingress
+
+- [WhatsApp](./whatsapp.md)
+- [Telegram](./telegram.md)
+- [Telegram (grammY notes)](./grammy.md)
+- [Slack](./slack.md)
+- [Discord](./discord.md)
+- [Signal](./signal.md)
+- [iMessage](./imessage.md)
+- [WebChat](./webchat.md)
+- [Webhooks](./webhook.md)
+- [Gmail Pub/Sub](./gmail-pubsub.md)
+
+## Gateway + operations
+
+- [Gateway runbook](./gateway.md)
+- [Gateway pairing](./gateway/pairing.md)
+- [Gateway lock](./gateway-lock.md)
+- [Background process](./background-process.md)
+- [Health](./health.md)
+- [Heartbeat](./heartbeat.md)
+- [Doctor](./doctor.md)
+- [Logging](./logging.md)
+- [Dashboard](./dashboard.md)
+- [Control UI](./control-ui.md)
+- [Control API (legacy)](./control-api.md)
+- [Remote access](./remote.md)
+- [Remote gateway README](./remote-gateway-readme.md)
+- [Tailscale](./tailscale.md)
+- [Security](./security.md)
+- [Troubleshooting](./troubleshooting.md)
+
+## Tools + automation
+
+- [Tools surface](./tools.md)
+- [Bash tool](./bash.md)
+- [Elevated mode](./elevated.md)
+- [Cron + wakeups](./cron.md)
+- [Thinking + verbose](./thinking.md)
+- [Models](./models.md)
+- [Agent send CLI](./agent-send.md)
+- [Terminal UI](./tui.md)
+- [Browser control](./browser.md)
+- [Browser (Linux troubleshooting)](./browser-linux-troubleshooting.md)
+
+## Nodes, media, voice
+
+- [Nodes overview](./nodes.md)
+- [Camera](./camera.md)
+- [Images](./images.md)
+- [Audio](./audio.md)
+- [Location command](./location-command.md)
+- [Voice wake](./voicewake.md)
+- [Talk mode](./talk.md)
+
+## Platforms
+
+- [macOS app overview](./macos.md)
+- [macOS dev setup](./mac/dev-setup.md)
+- [macOS menu bar](./mac/menu-bar.md)
+- [macOS voice wake](./mac/voicewake.md)
+- [macOS voice overlay](./mac/voice-overlay.md)
+- [macOS WebChat](./mac/webchat.md)
+- [macOS Canvas](./mac/canvas.md)
+- [macOS child process](./mac/child-process.md)
+- [macOS health](./mac/health.md)
+- [macOS icon](./mac/icon.md)
+- [macOS logging](./mac/logging.md)
+- [macOS permissions](./mac/permissions.md)
+- [macOS remote](./mac/remote.md)
+- [macOS signing](./mac/signing.md)
+- [macOS release](./mac/release.md)
+- [macOS bun gateway](./mac/bun.md)
+- [macOS XPC](./mac/xpc.md)
+- [macOS skills](./mac/skills.md)
+- [macOS Peekaboo plan](./mac/peekaboo.md)
+- [iOS node](./ios.md)
+- [Android node](./android.md)
+- [Windows app](./windows.md)
+- [Linux app](./linux.md)
+- [Web surfaces](./web.md)
+
+## Workspace + templates
+
+- [Skills](./skills.md)
+- [Skills config](./skills-config.md)
+- [Default AGENTS](./AGENTS.default.md)
+- [Templates: AGENTS](./templates/AGENTS.md)
+- [Templates: BOOTSTRAP](./templates/BOOTSTRAP.md)
+- [Templates: IDENTITY](./templates/IDENTITY.md)
+- [Templates: SOUL](./templates/SOUL.md)
+- [Templates: TOOLS](./templates/TOOLS.md)
+- [Templates: USER](./templates/USER.md)
+
+## Experiments + proposals
+
+- [Onboarding config protocol](./onboarding-config-protocol.md)
+- [Research: memory](./research/memory.md)
+- [Proposal: model config](./proposals/model-config.md)
+- [Refactor: agent loop](./refactor/agent-loop.md)
+- [Refactor: browser control simplification](./refactor/browser-control-simplification.md)
+- [Refactor: Canvas A2UI](./refactor/canvas-a2ui.md)
+- [Refactor: CLI unification](./refactor/cli-unification.md)
+- [Refactor: gateway client](./refactor/gateway-client.md)
+- [Refactor: gateway](./refactor/gateway.md)
+- [Refactor: new arch](./refactor/new-arch.md)
+- [Refactor: TUI](./refactor/tui.md)
+- [Refactor: web gateway troubleshooting](./refactor/web-gateway-troubleshooting.md)
+- [Refactor: webagent session](./refactor/webagent-session.md)
+
+## Testing + release
+
+- [Testing](./test.md)
+- [Release checklist](./RELEASING.md)
+- [Device models](./device-models.md)

docs/index.md

@@ -128,6 +128,7 @@ Example:
 ## Docs
 
 - Start here:
+  - [Docs hubs (all pages linked)](./hubs.md)
   - [FAQ](./faq.md) ← *common questions answered*
   - [Configuration](./configuration.md)
   - [Nix mode](./nix.md)