XBuckle

Local cloud runtime for apps and AI coding agents.

Site (GitHub Pages): https://21stware.github.io/xbuckle/
For agents: https://21stware.github.io/xbuckle/llms.txt · llms-full.txt

Documentation / site

npm run docs:dev      # http://localhost:5173/xbuckle/
npm run docs:build    # → docs/.vitepress/dist (+ regenerates llms-full.txt)
npm run docs:preview
npm run docs:llms     # regenerate docs/public/llms-full.txt only

Sources live in docs/. Pushing to main (docs paths) deploys via .github/workflows/pages.yml.

• Humans — desktop, replace local Supabase, Connect / Ship
• Agents — MCP, workflows, acceptance / dogfood, copy-paste prompts
• Installable skill — skills/xbuckle-local-cloud via npx skills add <owner>/<repo> -s xbuckle-local-cloud
• Serve — run runtime without UI (npm run serve / XBuckle --serve)
• Config SDK — packages/config (@xbuckle/config) for .xbuj / xbuckle:// links

Quick commands

npm install
npm run electron:dev          # desktop (starts runtime + UI)
npm run serve                 # runtime only, no UI (Node)
# packaged: XBuckle --serve   # runtime only, Electron userData, no window
npm run acceptance            # typecheck + build + golden suite
npm run origin:dogfood        # Origin scenario, read-only ORIGIN_ROOT
npm run electron:release      # signed + notarized macOS build → release/

Default endpoints: HTTP :3100 · MCP :3101 · Postgres :5432 · Redis :6379 · SMTP :1025.

macOS Developer ID signing + GitHub Release: see docs/guide/release.md.