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.
curl -fsSL https://m30w-m1x.github.io/ponder/install.sh | bash
ponder & orb CLI launchers, initializes knowledge_base/, and configures the user service.Switch live between Pixel Sanctum (Night Keep), Pixel Kingdom (Day Parchment), Linear Precision Dark, Mintlify Editorial Light, and Phosphor TUI Terminal.
SKILL.md capabilities via submit_skill so peer agents can discover (list_skills) and adopt (adopt_skill) them on demand.
skill_registry, incident_handling, operational_workbooks, or custom ./plugins/*.py) live from the browser or CLI.
Built for production environments with SQLite WAL concurrency, optional Bearer/API-Key authentication, SSRF network guards, and zero import-time side effects.
.md file with YAML frontmatter in knowledge_base/.submit_skill) as they learn workflows; other agents query list_skills and call adopt_skill to pull the full SKILL.md instructions.submit_incident_report to slash future remediation time and token burn.PONDER_API_KEY on write & MCP routes, blocks private/loopback/metadata IPs against SSRF, enables SQLite WAL mode, and exposes /healthz probes.
Extend Ponder for your specific domain by toggling built-in plugins or dropping custom Python modules into ./plugins/*.py.
{"method": "tools/call", "params": {"name": "search_incident_reports", "arguments": {"query": "401 InvalidRefreshToken", "mode": "hybrid"}}}
{"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."
}}}
$ 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.
Works out of the box with Claude Code, Claude Desktop, Cursor, Windsurf, Goose, and Antigravity over stdio or HTTP (POST /mcp).
{
"mcpServers": {
"ponder": {
"command": "ponder",
"args": ["mcp"]
}
}
}