Command-Line Tools

Shell Scripts

All scripts live in scripts/:

Script	Purpose
start-web.sh	Start Astro dev server (port 4321)
start-api.sh	Start Hono API server (port 2077)
start-mcp-gateway.sh	Start MCP gateway (port 8710)
publish-web.sh	Deploy to Cloudflare Pages via wrangler

Key Commands

Astro

npm run dev          # Start dev server
npm run build        # Production build
npm run preview      # Preview production build

Content Submodule

Content lives in akita-web/src/content as a git submodule (remote: akita-content).

cd akita-web/src/content
git pull             # Update content
git add . && git commit -m "..."  # Commit content changes

Qdrant

qdrant                           # Start the vector DB
curl http://localhost:6333/collections  # List collections

Package Managers

• npm — Astro frontend (akita-web/)
• Bun — API server
• uv / pip — MCP gateway (Python)