Sibyl
Collective intelligence runtime for AI agents. Knowledge graph + orchestration + persistent memory.
Install / Use
/learn @hyperb1iss/SibylQuality Score
Category
Development & EngineeringSupported Platforms
README
🔮 The Vision
AI agents that remember everything. A collective intelligence that compounds with every session. Orchestration that lets you manage a fleet of autonomous agents—all building on shared knowledge, all tracked in one place.
Today's agents have amnesia. Every session starts fresh. No memory of what worked, what failed, what you learned yesterday. Multiple agents across different features? Chaos.
Sibyl changes that.
A knowledge graph gives your agents persistent memory. Epics and tasks structure your work. Spawn agents that execute autonomously while you approve decisions and track progress. Solo dev? Your agents become your team. Actual team? Everyone's insights compound.
The whole becomes greater than the sum of its parts.
✦ What You Get
| Capability | What It Means | | ------------------------------ | ----------------------------------------------------------------------------------------------------------- | | 🔮 Collective Intelligence | Every agent contributes. Every session compounds. The graph gets smarter over time | | 🎯 Semantic Search | Find knowledge by meaning—"authentication patterns" finds OAuth solutions even if "OAuth" isn't in the text | | 🧠 Persistent Memory | What you learn today helps tomorrow. AI agents remember across sessions | | ⚡ Agent Orchestration | Spawn Claude agents that work autonomously with human-in-the-loop approvals | | 🦋 Task Workflow | Plan with epics and tasks. Track parallel work across agents. See everything in one place | | 📚 Doc Ingestion | Crawl and index external documentation into your graph | | 🏢 Multi-Tenancy | Isolated graphs per organization. Enterprise-ready from day one | | 🌐 Graph Visualization | Interactive D3 visualization of your knowledge connections |
<table> <tr> <td align="center"> <img src="docs/images/dashboard.png" alt="Dashboard" width="400"><br> <sub>Dashboard</sub> </td> <td align="center"> <img src="docs/images/projects.png" alt="Projects" width="400"><br> <sub>Projects</sub> </td> </tr> <tr> <td align="center"> <img src="docs/images/graph.png" alt="Graph" width="400"><br> <sub>Knowledge Graph</sub> </td> <td align="center"> <img src="docs/images/tasks.png" alt="Tasks" width="400"><br> <sub>Task Workflow</sub> </td> </tr> </table>⚡ Quickstart
One-Liner Install
curl -fsSL https://raw.githubusercontent.com/hyperb1iss/sibyl/main/install.sh | sh
Installs uv (if needed), installs sibyl-dev, starts Sibyl. Done.
Manual Install (UV)
uv tool install sibyl-dev
sibyl local start
Alternative: pipx
pipx install sibyl-dev
sibyl local start
CLI Commands
sibyl local start # Start all services
sibyl local stop # Stop services
sibyl local status # Show running services
sibyl local logs # Follow logs
sibyl local reset # Nuke and start fresh
Development Setup
# One-line setup (installs proto, moon, toolchain, dependencies)
./setup-dev.sh
# Or manually:
curl -fsSL https://moonrepo.dev/install/proto.sh | bash
proto use # Installs node, pnpm, python, uv
proto install moon
uv sync && pnpm install
# Configure
cp apps/api/.env.example apps/api/.env
# Add SIBYL_OPENAI_API_KEY + SIBYL_JWT_SECRET
# Launch everything
moon run dev
# Verify
curl http://localhost:3334/api/health
Ports:
| Service | Port | URL | | --------- | ---- | --------------------- | | API + MCP | 3334 | http://localhost:3334 | | Web UI | 3337 | http://localhost:3337 | | FalkorDB | 6380 | — |
🤖 Agent Orchestration
Sibyl's flagship feature: spawn AI agents that work autonomously while you review and approve their actions.
How It Works
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Web UI │────▶│ Sibyl │────▶│ Claude │
│ (approve) │◀────│ (orchestr) │◀────│ (agent) │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
│ ▼ │
│ ┌─────────────┐ │
└──────────▶│ Knowledge │◀────────────┘
│ Graph │
└─────────────┘
- Spawn agents from the web UI or CLI with a task description
- Agents work autonomously using Claude SDK with your knowledge graph as context
- Human-in-the-loop approvals for destructive operations, sensitive files, external APIs
- Progress streams in real-time via WebSocket to the chat UI
- Checkpoints save state so agents can resume after interruptions
Agent Features
- Task Assignment — Agents claim tasks and update status automatically
- Git Worktrees — Each agent works in an isolated worktree to prevent conflicts
- Approval Queue — Review and approve/deny agent actions before execution
- Cost Tracking — Monitor token usage and USD cost per agent
- Checkpointing — Save/restore agent state for crash recovery
- Multi-Agent — Multiple agents can collaborate on related tasks
Spawning an Agent
Web UI: Navigate to /agents → Click "Spawn Agent" → Describe the task
CLI:
sibyl agent spawn --task task_abc123 "Implement the OAuth flow"
REST API:
curl -X POST http://localhost:3334/api/agents \
-H "Authorization: Bearer $TOKEN" \
-d '{"prompt": "Implement OAuth", "task_id": "task_abc123"}'
The CLI
The CLI is the power-user interface. Clean output, optimized for scripting and AI agent consumption.
# Install globally
moon run install-cli
# Or use directly
uv tool install sibyl-cli
Core Commands
# Search your knowledge
sibyl search "authentication patterns"
sibyl search "OAuth" --type pattern
# Add knowledge
sibyl add "Redis connection pooling" "Pool size must be >= concurrent requests to avoid blocking"
# Task workflow
sibyl task list --status todo,doing
sibyl task start task_abc
sibyl task complete task_abc --learnings "Key insight: always check TTL first"
# Explore the graph
sibyl explore related ent_xyz # Find connected entities
sibyl explore communities # View knowledge clusters
Task Workflow
backlog ──▶ todo ──▶ doing ──▶ review ──▶ done ──▶ archived
│
▼
blocked
Output Formats
sibyl task list # JSON (default, for scripts)
sibyl task list --table # Human-friendly table
sibyl task list --csv # For spreadsheets
Web UI
A full admin interface at http://localhost:3337:
- Dashboard — Stats overview, recent activity, quick actions
- Agents — Spawn, monitor, and chat with AI agents
- Tasks — Kanban-style workflow with inline editing
- Graph — Interactive D3 visualization of knowledge connections
- Search — Semantic search with filters
- Sources — Configure documentation crawling
- Settings — Organizations, API keys, preferences
Built with: Next.js 16, React 19, React Query, Tailwind CSS, SilkCircuit design system
MCP Integration
Connect Claude Code, Cursor, or any MCP client to Sibyl:
{
"mcpServers": {
"sibyl": {
"type": "http",
"url": "http://localhost:3334/mcp",
"headers": {
"Authorization": "Bearer sk_you
Related Skills
node-connect
354.3kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
112.3kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
Hook Development
112.3kThis skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.
MCP Integration
112.3kThis skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP, WebSocket). Provides comprehensive guidance for integrating Model Context Protocol servers into Claude Code plugins for external tool and service integration.
