Hybrid ChromaDB + SQLite FTS5 Agent Skill Registry Incident & Workbook Plugins MCP Server

Ponder the Orb. One Knowledge Vault for Humans & Agents.

Ponder keeps standard YAML-frontmatter Markdown files on disk as the single source of truth, while indexing every chunk into a Hybrid Vector + BM25 Search Engine. It ships with a 5-theme dynamic Web UI, a centralized Agent Skill Registry (SKILL.md), and toggleable plugins for Incident Handling & Resolution.

One-Line Installer (Linux & macOS)
$ curl -fsSL https://m30w-m1x.github.io/ponder/install.sh | bash
Installs ponder & orb CLI launchers, initializes knowledge_base/, and configures the user service.
ORB TELEMETRY — MCP & HYBRID RRF SESSION
# 1. Collect system man pages, web docs, or notes $ ponder collect man git curl grep ssh jq ✓ Indexed 819 structured section chunks into ChromaDB + FTS5 # 2. Agent submits a reusable skill to the centralized registry $ ponder skill submit postgres-deadlock-triage \ "Diagnose and resolve PostgreSQL lock contention" \ "1. Query pg_blocking_pids()..." --triggers "deadlock,pg_locks" ✓ Published knowledge_base/skills/postgres-deadlock-triage/SKILL.md # 3. Agent queries incident reports via Hybrid RRF Search $ orb query "InvalidRefreshToken grace window" --mode hybrid #1 incidents/inc-4012_jwt_refresh_token_race_condition.md (score: 0.0328) Fix: Added 10s idempotent reuse grace window in Redis keyed by (token_family_id, generation). Zero 401 errors under 64-thread k6 test.

Five Switchable Product Themes. Zero Static Build Step.

Switch live between Pixel Sanctum (Night Keep), Pixel Kingdom (Day Parchment), Linear Precision Dark, Mintlify Editorial Light, and Phosphor TUI Terminal.

01 • Pixel Sanctum (Night Keep) Knowledge Base & Skill Reader
Ponder Pixel Sanctum Knowledge Base View
3-pane layout with left repository filter, rendered Markdown stage, and right YAML frontmatter + heading outline + MCP inspector.
02 • Centralized Agent Skill Registry SKILL.md Hub
Ponder Centralized Agent Skill Registry
AI agents publish reusable SKILL.md capabilities via submit_skill so peer agents can discover (list_skills) and adopt (adopt_skill) them on demand.
03 • Pixel Kingdom (Day Parchment) Toggleable Plugins & Schemas
Ponder Pixel Kingdom Plugins and Artifact Schemas
Enable or disable modular plugins (skill_registry, incident_handling, operational_workbooks, or custom ./plugins/*.py) live from the browser or CLI.
04 • Linear Precision Dark Hybrid RRF Search & Incident Retrieval
Ponder Linear Theme Hybrid Search
Reciprocal Rank Fusion (RRF) merges ChromaDB semantic vector rankings with SQLite FTS5 BM25 keyword rankings so exact error codes and conceptual queries both hit #1.

Architectural Ledger

Built for production environments with SQLite WAL concurrency, optional Bearer/API-Key authentication, SSRF network guards, and zero import-time side effects.

A
Markdown Vault
Every note, man page, scraped doc, skill, workbook, and incident report lives as a clean .md file with YAML frontmatter in knowledge_base/.
B
Hybrid RRF Engine
Combines ChromaDB cosine similarity vectors with SQLite FTS5 Porter-stemmed BM25 search via Reciprocal Rank Fusion, plus SHA-256 content-hash tracking for incremental syncs.
C
Central Skill Server
Agents submit new skills (submit_skill) as they learn workflows; other agents query list_skills and call adopt_skill to pull the full SKILL.md instructions.
D
Incident Intelligence
When an agent resolves an issue, it pushes an Incident Report (Issue, Discovery, Cause, Fix, Verification) via submit_incident_report to slash future remediation time and token burn.
E
Production Hardening
Enforces PONDER_API_KEY on write & MCP routes, blocks private/loopback/metadata IPs against SSRF, enables SQLite WAL mode, and exposes /healthz probes.

Incident Workflow & Custom Plugins

Extend Ponder for your specific domain by toggling built-in plugins or dropping custom Python modules into ./plugins/*.py.

01

Agent Receives an Issue & Queries Past Incidents

{"method": "tools/call", "params": {"name": "search_incident_reports", "arguments": {"query": "401 InvalidRefreshToken", "mode": "hybrid"}}}
02

Agent Performs Discovery, Root-Cause & Fix Analysis, Then Publishes Report

{"method": "tools/call", "params": {"name": "submit_incident_report", "arguments": {
  "title": "JWT Refresh Token Race Condition Under Parallel Tab Requests",
  "incident_id": "INC-4012",
  "severity": "high",
  "issue": "Intermittent 401 InvalidRefreshToken during concurrent tab requests.",
  "discovery": "Two requests arrived within 14ms presenting the same refresh token.",
  "cause": "Immediate token rotation without an in-flight grace window.",
  "fix": "Added 10-second idempotent reuse grace window in Redis.",
  "verification": "64-thread k6 load test passed with 0 errors across 50,000 rotations."
}}}
03

Enable or Disable Any Plugin at Runtime

$ ponder plugin list
- skill_registry [ENABLED] (v1.0.0 • builtin): Centralized Agent Skill Registry
- operational_workbooks [ENABLED] (v1.0.0 • builtin): Operational Workbooks & Runbooks
- incident_handling [ENABLED] (v1.0.0 • plugins/incident_handling.py): Incident Handling & Resolution

$ ponder plugin disable skill_registry
Plugin 'skill_registry' is now DISABLED.

Connect Any MCP Client (`ponder mcp`)

Works out of the box with Claude Code, Claude Desktop, Cursor, Windsurf, Goose, and Antigravity over stdio or HTTP (POST /mcp).

⚙

MCP Client Configuration

{
  "mcpServers": {
    "ponder": {
      "command": "ponder",
      "args": ["mcp"]
    }
  }
}