Skip to content
Celestial Intelligence Docs

Scribe

Scribe is the capture + derivation layer of celestial-intelligence. It sits between raw event sources (Claude Code session JSONL files, repos, RSS feeds, web pages, code symbols) and the typed projections the rest of the platform consumes (geo_documents, geo_issues, geo_proposals, atoms, wiki_pages, embeddings).

Two halves:

  • scribe-ingest — a file watcher (per ADR-051) that tails local JSONL session files + repo state and writes raw events into chat_events, messages, and atoms. Runs as a per-machine daemon.
  • scribe-memory — a fleet of processors that read from those raw tables and emit typed derived rows. Each processor is a small stateless Pipeline implementation, registered in a process-wide registry.

In this section

Section titled “In this section”
  • Processors — the operator’s reference: invocation, catalogue of all 35 registered processors, telemetry contract, and how to add a new one.
Section titled “Related”
  • ADR-049 — conversations + turns schema
  • ADR-051 — scribe architecture (watcher + processor pattern)
  • ADR-055 — repo atoms (the upcoming repo-* processor family)
  • ADR-058 — geodesic PM substrate (the geodesic.* processors)
  • /geodesic/runs in the dashboard — live telemetry from processor_runs and processor_cursors.