NS-HUB

Personal AI Operating System for Claude Code

Jayone  ·  Building a Personal AI OS, one milestone at a time.
Claude Code (Agent)
Creates stones · hooks fire on every tool use · reports completion with evidence URL
MCP tools: get_pending_task / report_task_complete
NS-Hub Server
FastAPI · Turso DB · systemd · Telegram notifications · GDrive evidence pipeline
REST API / WebSocket / static HTML
Northstar UI
Real-time milestone table · evidence popup · commit flow · multi-project kanban
Turso HTTP API v2 pipeline
ctx DB
  • BM25 retrieval
  • Session memory
  • Hook telemetry
hub DB
  • stones (milestones)
  • hub_usage stats
  • thread history
Stone Lifecycle
  • queued → in_progress → pending_confirmation → done
  • Layer A/B: evidence gating before close
  • Auto-archive daemon (6h sweep)
Hook System
  • PostToolUse — stone-ctx bridge per task fetch
  • Stop — session telemetry + vault backup
  • UserPromptSubmit — BM25 + language guard
Evidence System
  • rclone → GDrive upload + URL resolution
  • Filename resolve via Drive API (8ms, cached)
  • ! badge persists until user confirms
Multi-Project
  • MOAT · Sales · FRWP · UniversEye · Hub · Crons
  • Per-project isolation + shared hub server
  • Cross-project artifact registry
ctx Memory Layer
  • BM25 + dense vector RRF per stone
  • Session aggregates → long-horizon context
  • Independent from hub (bridge hook only)