✨ Open source · Local-first · AI-native · MCP-ready

Your workspace.
One command center.

Scan your workspace. Search with AI. Keep docs healthy. Track decisions. 23 MCP tools, 60 API endpoints, 1,099 tests.

Install from npm GitHub
$ npx the-hub
localhost:9002
The Hub — Morning Briefing
Features
Everything you need.
Nothing you don't.

A config file, your directories, and one command. The Hub handles the rest.

Enhanced Search

Cmd+K universal search with group/type filters, recent searches, server-side FTS5 results, and semantic vector search.

Smart Grouping

Glob patterns group files into logical tabs. Planning docs, knowledge base, deliverables — your structure.

Intelligence Briefing

Unified morning briefing with predictive insights, pending reviews, active decisions, impact scoring, calendar context, and change feed.

Document Hygiene

7 detection engines with batch archive/delete. Async analysis via job queue. AI review suggests merges.

MCP Server

12 tools, 3 resources, 5 prompt templates. Claude Code, Cursor, and ChatGPT all query your workspace via MCP.

Observable & Reliable

Structured logging, system status page, error surfacing, circuit breaker on AI calls, setup wizard for guided onboarding.

In action
See it for yourself.

Every screen is real. Generic demo data — no personal information.

Planning Tab
Planning— curated panels alongside grouped artifacts
Knowledge Tab
Knowledge— docs and resources with quick-access links
Document Hygiene
Hygiene— duplicate detection with AI-powered review
Command Palette
Cmd+K— universal search across everything
Connected Repos
Connected Repos— auto-discovered git repos with branch and activity info
Architecture
Simple by design.

Config-driven. Server-rendered. File-watching. Zero cloud required.

hub.config.ts
your config
→
Scanner + Watcher
chokidar, 5s debounce
→
Next.js API
60 endpoints
→
React UI
server-rendered
→
AI Gateway
optional
Philosophy
Opinionated by choice.

Every design decision serves a purpose.

Local-first your disk

Your files stay on your machine. No cloud account, no sync service, no data exfiltration. Everything works offline.

Config-driven one file

One TypeScript file defines your entire workspace. Tabs, groups, panels, templates — all in hub.config.ts.

AI-augmented optional

Every feature works without AI. The gateway is pluggable — use Claude, GPT, Ollama, or nothing at all.

Launchpad not destination

The Hub indexes, orients, and dispatches. It sends you to the right tool — it doesn't replace your editor.

What's built
Six versions. Done.

157 PRs shipped. 1,099 tests. 60 API endpoints. 23 MCP tools. v6: the context engine.

Phase 1 ✅

Foundation

8 steps
  • SQLite + FTS5 search
  • 30+ file types (PDF, code)
  • MCP server + CLI
  • Import tools (Notion, Obsidian)
Phase 2 ✅

Intelligence

9 steps
  • RAG Q&A + semantic search
  • AI summarization + generation
  • Knowledge graph + trends
  • Ollama (zero-config AI)
Phase 3 ✅

Platform

6 steps
  • Plugin system + marketplace
  • GitHub plugin
  • Webhooks + agents
  • API auth + MCP v2 (6 core tools, 5 prompts)
Phase 4 ✅

Network

7 steps
  • PWA + Docker deploy
  • Hub-to-Hub federation
  • Shared instances + roles
  • Governance + audit logs
v3: Depth Over Breadth

25 items across 4 phases — surfacing hidden features, adding observability, polishing core UX, and evolving MCP.

Phase 1 ✅

Foundation

6 items
  • Setup wizard + status page
  • Structured logging + error surfacing
  • Circuit breaker + graceful degradation
Phase 2 ✅

Surface What's Built

7 items
  • Integration dashboard + decision browser
  • Review panel + annotations + share
  • Predictive briefing + impact badges
Phase 3 ✅

Core Quality

7 items
  • Search UX + briefing overhaul
  • Graph interactivity + hygiene actions
  • Vector search + async jobs + lazy loading
Phase 4 ✅

MCP Evolution

5 items
  • 5 prompt templates + SSE subscriptions
  • Health resource + 3 new tools
  • Connection tester UI
v4: Agent Intelligence

20 items — making The Hub an agent-native knowledge backend with memory, decisions, and automation.

Phase 1 ✅

Agent Core

5 items
  • Agent memory (remember/recall)
  • Decision queries + contradiction detection
  • Auto context compilation
Phase 2 ✅

Automation

5 items
  • Knowledge gap detection
  • Change pipeline + smart summaries
  • Session tracking + catch-up
Phase 3 ✅

Communication

5 items
  • Slack weekly digest
  • Notification system
  • Pre-meeting briefings
Phase 4 ✅

Performance

5 items
  • Embedding auto-gen + pruning
  • Streaming manifest + mobile responsive
  • Benchmarks + query audit
v5: Ship Less, Use More

15 items — making what works exceptional, wiring real automation, deleting what doesn't.

Excellence ✅

Core Quality

5 items
  • Search caching (< 50ms p95)
  • Briefing optimization (< 500ms)
  • MCP caching (< 100ms) + keyboard nav
Automation ✅

Wire It For Real

5 items
  • Scheduled Slack digest (real cron)
  • Calendar-driven briefings (iCal)
  • Notification triggers + inbox
Cleanup ✅

Cut Dead Weight

5 items
  • Archive 13 unused MCP tools
  • Deprecate 8 API routes
  • Integration tests + honest marketing
v6: The Context Engine

19 items — delete 5,000 lines, rebuild as MCP-first context engine with proactive intelligence and quality scoring.

Delete ✅

The Great Deletion

5 items
  • -5,023 lines of dead code
  • 11 routes, 11 modules, 13 MCP tools deleted
  • 73 → 59 modules consolidated
MCP-First ✅

Context Engine

5 items
  • workspace_summary (1-call orientation)
  • Write-back tools + smart context windows
  • hub://health resource
Proactive ✅

Push Intelligence

5 items
  • Auto-gen .hub-context.md + .cursorrules
  • VS Code extension + Slack alerts
  • CLI: hub context, hub stale
Quality ✅

Quality Engine

4 items
  • Hygiene-as-code + auto-fix suggestions
  • Doc lifecycle (draft→active→stale→archived)
  • Per-artifact quality scores (A-F)
Stack
Built with

Modern tooling. Zero cloud dependencies. Production-ready.

Next.js 15 React 19 SQLite (FTS5) MCP SDK Tailwind CSS v4 TypeScript vitest (1,099 tests) Docker Ollama chokidar Turbopack
One command. Done.

npx the-hub

GitHub npm →