blackbox¶
Blackbox is the daemon that keeps agent work from evaporating.
It indexes transcripts and project source, turns them into a graph agents can
walk, stores rules and decisions in one knowledge store, and runs multi-provider
work through bro. The point is not another search box. The point is that a
fresh agent can answer "where did this come from?", "what already decided this?",
and "which task is still alive?" without guessing from memory.
The crate is blackbox. It produces four binaries:
| Binary | Purpose |
|---|---|
blackboxd |
HTTP-MCP daemon. Run one long-lived user service per host. |
bro |
Terminal TUI for tailing live orchestration activity |
bro-slack |
Slack sidecar bridge. Translates Slack events into the daemon's webhook pipeline. |
bro-irc |
LAN IRC bridge. Relays IRC commands to bro exec/resume/status. |
Docs¶
| Page | What it covers |
|---|---|
| Getting Started | Build, install, systemd service, connect CLIs, bootstrap |
| Operating Guide | Day-2 runbooks: reindexing, re-embedding, compaction, post-update checks |
| Internals | Map of the internal projections and where the deeper design pages live |
| Graph And Retrieval Internals | Graph grounding, opening sequence, entity refs, edges, hybrid search ranking |
| Index And Embedding Internals | Tantivy indexing, embedding queues, schema migration, vector and edge compaction |
| Workflow Engine | Canonical reference for authoring and running workflows |
| Atoms | Install, discover, invoke, resume, and bind reusable capabilities |
| Rule Packets | Compile, audit, apply. First-match-wins classification. |
| Refactor Tools And Atoms | Structural refactor primitives plus shipped Java/Rust refactor atoms |
| Bro Runtime | Direct dispatch, resume, wait, teams, brofiles, and provider runtime controls |
| Knowledge Store | Learn, decide, remember, pin, render, review, notes, and inbox |
| Transcript Retrieval | Search, cite, context, sessions, messages, topics, and freshness checks |
| Projects And Code Indexing | Project registration, .bbox, code navigation, reindex, and reembed |
| Artifact Catalog | Install, list, supersede, and reason about system-defaults/ |
| Agent System | Legacy registered-agent compatibility surface |
| Ingress Paths | Webhooks, pollers, and crons. One routing pipeline. |
| Slack Bridge | Sidecar architecture, channel binding, triage workflow, proposal lifecycle |
| IRC Bridge | LAN couch steering, ngircd setup, commands, council integration |
| Councils & Whiteboards | Structured multi-agent deliberation (phased boards, councils) |
Quick links¶
- Source: github.com/invidious9000/transcript-search
- Key paths:
~/.local/state/blackbox/(index, knowledge, threads, notes),~/.bro/(tasks, teams, MCP config) - Env vars:
BBOX_PORT(default 7264),TRANSCRIPT_SEARCH_ROOTS,TRANSCRIPT_SEARCH_INDEX_PATH