Skip to content

Run the Observatory

Copy page
Terminal window
tapestry observatory

This opens the console in your browser. You can also open /observatory directly.

The Observatory is part of the platform — one deployed console. Once a project is onboarded with tapestry onboard, its coordination data flows into it.

For development, run the docs site locally. From apps/docs-site, one line at a time (PowerShell doesn’t accept &&):

Terminal window
cd apps/docs-site
npm install
npm run dev

Open the URL it prints and add /observatory. In local dev the console reads this machine’s hook telemetry (~/.claude/logs/hooks.jsonl) when present; otherwise it uses a bundled sample.

The console and its feed render on demand (serverless functions); the doc pages stay static. The deployment uses:

  • the @astrojs/vercel adapter (^8, for Astro 5) in astro.config.mjs,
  • Node.js 22.x in the Vercel project — the serverless functions do not run on Node 24,
  • no Vercel Output Directory override — the adapter controls the output.

By default the deployed console runs on a bundled sample. To feed it live data, see The Observatory feed.