NS-HUB

Milestone Orchestration Layer for Claude Code · Personal AI OS
Jayone  ·  Building a Personal AI Operating System, one milestone at a time.
Claude Code (Agent)
  • Creates stones (tasks) per project
  • Hooks fire on every tool use
  • Reports completion with evidence
NS-Hub Server
  • FastAPI · Turso DB · systemd-managed
  • MCP tools: get_pending_task, report_task_complete
  • Telegram notifications + GDrive evidence
Northstar UI
  • Real-time milestone table (stones)
  • Evidence popup · Commit flow
  • Multi-project kanban view
ctx DB
  • Session memory
  • BM25 retrieval
  • Hook telemetry
hub DB
  • stones (milestones)
  • hub_usage stats
  • thread history
Stone Lifecycle
  • queued → in_progress → pending_confirmation → done
  • Layer A/B: evidence upload gating before close
  • Auto-archive after 6h daemon sweep
Hook System
  • PostToolUse — stone-ctx bridge on every task fetch
  • Stop — session telemetry, vault incremental backup
  • UserPromptSubmit — BM25 memory, language guard
Evidence System
  • rclone → GDrive upload + URL resolution
  • Evidence popup: filename, image preview, history
  • ! badge persists until user confirms
Multi-Project
  • MOAT · Sales · FRWP · UniversEye · Hub · Crons
  • Per-project stone isolation + shared hub server
  • Cross-project artifact registry (INDEX.md)
ctx Memory Layer
  • BM25 + dense vector RRF retrieval per stone
  • Session aggregates → long-horizon context
  • Independent from hub — bridge hook only