feat: migrate landing to Astro + Starlight with docs and blog

Replace static HTML landing page with Astro framework:
- Docs section powered by Starlight (sidebar, search, dark mode)
- Blog section with markdown content collections
- Existing landing page migrated to Astro page with Docs/Blog nav links
- Starlight themed with Spool amber accent and Geist fonts
- All doc content fact-checked against codebase, CLI marked as coming soon
- CI workflow updated to run astro build

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: doodlewind

.github/workflows/deploy-landing.yml

@@ -23,8 +23,11 @@ jobs:
         with:
           node-version: 22
 
+      - name: Install dependencies
+        run: pnpm install --filter @spool/landing...
+
       - name: Build
-        run: cp -r packages/landing/public packages/landing/dist
+        run: pnpm --filter @spool/landing build
 
       - name: Deploy to Cloudflare Pages
         uses: cloudflare/wrangler-action@v3

.gitignore

@@ -14,6 +14,9 @@ dist-electron/
 # Turbo cache
 .turbo/
 
+# Astro
+.astro/
+
 # Source maps
 *.js.map
 *.d.ts.map

packages/landing/astro.config.mjs

@@ -0,0 +1,53 @@
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+import sitemap from '@astrojs/sitemap';
+
+export default defineConfig({
+  site: 'https://spool.pro',
+  outDir: './dist',
+  integrations: [
+    starlight({
+      title: 'Spool',
+      logo: {
+        light: './src/assets/logo-light.svg',
+        dark: './src/assets/logo-dark.svg',
+      },
+      social: [
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/spool-lab/spool' },
+        { icon: 'x.com', label: 'X', href: 'https://x.com/spoollabs' },
+        { icon: 'discord', label: 'Discord', href: 'https://discord.gg/aqeDxQUs5E' },
+      ],
+      customCss: ['./src/styles/starlight-overrides.css'],
+      sidebar: [
+        {
+          label: 'Getting Started',
+          items: [
+            { label: 'Installation', slug: 'docs/installation' },
+            { label: 'Quick Start', slug: 'docs/quick-start' },
+          ],
+        },
+        {
+          label: 'Guides',
+          items: [
+            { label: 'Agent Integration', slug: 'docs/guides/agent-integration' },
+            { label: 'Data Sources', slug: 'docs/guides/data-sources' },
+          ],
+        },
+        {
+          label: 'Reference',
+          items: [
+            { label: 'CLI Commands', slug: 'docs/reference/cli' },
+            { label: 'Configuration', slug: 'docs/reference/configuration' },
+          ],
+        },
+      ],
+      head: [
+        {
+          tag: 'meta',
+          attrs: { property: 'og:image', content: 'https://spool.pro/og-image.png' },
+        },
+      ],
+    }),
+    sitemap(),
+  ],
+});

packages/landing/src/assets/logo-dark.svg

@@ -0,0 +1,18 @@
+import { defineCollection, z } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+const docs = defineCollection({ schema: docsSchema() });
+
+const blog = defineCollection({
+  type: 'content',
+  schema: z.object({
+    title: z.string(),
+    description: z.string(),
+    date: z.coerce.date(),
+    author: z.string().default('Yifeng'),
+    tags: z.array(z.string()).default([]),
+    draft: z.boolean().default(false),
+  }),
+});
+
+export const collections = { docs, blog };

packages/landing/src/assets/logo-light.svg

@@ -0,0 +1,37 @@
+---
+title: "Introducing Spool: The Missing Search Engine for Your Own Data"
+description: "Why we built a local search engine for developers who think with AI — and how it works."
+date: 2026-04-02
+author: Yifeng
+tags: [announcement, product]
+---
+
+If you use Claude Code, Codex, or any AI coding agent daily, you've accumulated hundreds of sessions. Each one contains decisions, debugging breakthroughs, architectural discussions — your best thinking, scattered across session files on your machine.
+
+Spool makes all of that searchable.
+
+## The problem
+
+Your past agent sessions are gold. You've solved hard problems, explored trade-offs, and built up context that's invaluable for future work. But there's no good way to find any of it.
+
+You can't grep through JSONL files and get useful results. You can't ask your agent "what did we discuss about caching last month?" because it has no memory across sessions.
+
+## How Spool works
+
+Spool watches your session directories in real time. Every conversation becomes searchable the moment it's written — no manual export, no copy-paste.
+
+It also indexes data from 50+ platforms via [OpenCLI](https://github.com/jackwener/opencli): your GitHub stars, Twitter bookmarks, Reddit saves, and more. All local, all on your machine.
+
+## Agent-native search
+
+The key insight: your coding agent is already the best search engine you have. It just needs access to your personal data.
+
+With the `/spool` skill in Claude Code, your agent can search your past sessions and pull matching context directly into the current conversation. Ask it to "build on last month's auth discussion" and it actually can.
+
+## Try it
+
+```bash
+curl -fsSL https://spool.pro/install.sh | bash
+```
+
+Spool is open source and runs entirely on your machine. [Star us on GitHub](https://github.com/spool-lab/spool) if this resonates.

packages/landing/src/content.config.ts

@@ -0,0 +1,31 @@
+---
+title: Agent Integration
+description: Use Spool as a search backend for your AI coding agents.
+---
+
+Spool is designed to work with AI coding agents. Your agent can search your personal data — past sessions, bookmarks, stars — through the `/spool` skill in Claude Code.
+
+## Claude Code integration
+
+The `/spool` skill is available inside Claude Code. When your agent needs context from previous work, it can search Spool and pull matching fragments directly into the conversation.
+
+### Example usage
+
+```
+> build on last month's caching discussion
+```
+
+Spool returns matching fragments with source attribution (which session, which platform), and your agent uses them as context.
+
+## How it works
+
+1. Your agent invokes the `/spool` skill with a search query
+2. Spool searches the local SQLite index (Claude sessions, Codex sessions, OpenCLI data)
+3. Matching fragments are returned with source metadata
+4. Your agent incorporates the context into its response
+
+## Other agents
+
+:::note[Coming Soon]
+A standalone `spool` CLI is under development, which will allow any agent or script to search the Spool index from the terminal.
+:::

packages/landing/src/content/blog/hello-spool.md

@@ -0,0 +1,46 @@
+---
+title: Data Sources
+description: Platforms and data types that Spool can index.
+---
+
+Spool indexes data from two main sources: **agent sessions** (watched automatically) and **platform data** (pulled via OpenCLI).
+
+## Agent sessions (automatic)
+
+Spool watches these directories in real time:
+
+| Agent | Path |
+|-------|------|
+| Claude Code | `~/.claude/projects/` |
+| Claude Code (profiles) | `~/.claude-profiles/*/projects/` |
+| Codex CLI | `~/.codex/sessions/` |
+| Codex CLI (profiles) | `~/.codex-profiles/*/sessions/` |
+
+New sessions become searchable the moment they're written. No manual export needed.
+
+## Platform data (via OpenCLI)
+
+[OpenCLI](https://github.com/jackwener/opencli) pulls your bookmarks, stars, and saves from 50+ platforms to your machine. Spool indexes everything it captures.
+
+### Supported platforms
+
+- **Code**: GitHub Stars, GitLab Stars, Bitbucket
+- **Social**: Twitter/X Bookmarks, Reddit Saved, Hacker News Favorites
+- **Video**: YouTube Likes, Bilibili Favorites
+- **Reading**: Substack, Medium Bookmarks, Pocket, Instapaper
+- **Professional**: LinkedIn Saved, Slack Bookmarks
+- **Notes**: Notion, Obsidian, Apple Notes
+- And 40+ more
+
+### Pulling data
+
+```bash
+# Pull from a specific platform
+opencli pull github-stars
+opencli pull twitter-bookmarks
+
+# Pull from all configured platforms
+opencli pull --all
+```
+
+Spool watches the OpenCLI output directory and indexes new data as it arrives.

packages/landing/src/content/docs/docs/guides/agent-integration.md

@@ -0,0 +1,23 @@
+---
+title: Installation
+description: Install Spool on your machine.
+---
+
+Spool runs locally on macOS (Apple Silicon).
+
+## Quick install
+
+```bash
+curl -fsSL https://spool.pro/install.sh | bash
+```
+
+This downloads the latest `.dmg` from GitHub Releases, mounts it, and copies `Spool.app` to `/Applications`.
+
+## Requirements
+
+- macOS on Apple Silicon (M1+)
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or any ACP-compatible agent
+
+## Verify installation
+
+After installation, launch Spool from `/Applications` or Spotlight. The app will start indexing your Claude Code sessions automatically.