Orb

Orb

A multi-profile messaging shell around Claude Code CLI.

What Orb Is

Orb receives messages from a platform adapter, routes them to the right profile, starts or resumes a per-thread Claude Code CLI session, and sends the result back. Orb does not replace Claude Code's runtime. It supplies routing, profile isolation, long-term recall, document search, cron execution, and approval handling around the native CLI.

You (Slack DM / thread)
        |
        v
      Orb
        |
        v
Claude Code CLI (one worker per thread, cwd = profiles/{name}/workspace/)
        |
        v
      Reply

Why Claude Code Native

• Claude Code already auto-discovers CLAUDE.md, workspace skills, workspace agents, and CLI-managed memory from the current working directory.
• Orb stays outside the agent runtime. It handles message routing, context assembly, profile boundaries, cron orchestration, and permission relay.
• Claude Code upgrades land without a prompt-stack migration inside Orb.
• The worker process talks to Claude Code over native stream-json, so Orb can reuse sessions for follow-up turns in the same thread instead of rebuilding an agent loop of its own.

Features

• Multi-profile isolation with separate scripts/, workspace/, and data/ directories per profile.
• Slack Socket Mode adapter for production use. The PlatformAdapter abstraction stays, but Orb ships a single Slack instance; alternative platforms would require a custom adapter.
• Holographic long-term memory in local SQLite for fact extraction, trust scoring, decay controls, and write-time arbitration.
• DocStore full-text search in local SQLite FTS5, with project slug inference from the thread and registry-driven path mapping.
• Cron scheduling with per-profile cron-jobs.json, fire-and-forget workers, and per-job inflight guards.
• MCP permission relay that can surface Claude Code approval