LOCAL-FIRST · SCOPED · SOURCE VERSION 2026.8.4

Memory your agents can share without sharing everything.

Dreamcatcher gives Hermes, Claude Code, and Codex one canonical SQLite ledger. Retrieval is the default, so saved facts are available immediately. Private agents and projects stay isolated by scope. You keep the database and its audit history on your machine.

Read the setup flow

private/carloDeployment requires a clean diff and rollback target.

project/atlasUse snake_case for new database tables.

sharedProduction changes require explicit approval.

ARCHITECTURE

One ledger with enforced boundaries.

Every record belongs to shared, private/<agent>, or an authorized project/<id> scope. Identity comes from trusted MCP transport context instead of tool arguments. Shared records require explicit promotion, while sensitive lifecycle changes require confirmation. Provenance, actor, consent source, lifecycle state, and trace ID remain inspectable.

Immediate recall

Agents can search and recall a record as soon as it is written.

Profile isolation

Private memory stays private across search, direct lookup, tasks, and audits.

Recoverable changes

Corrections and restores append versions, and deletion keeps a recoverable record.

MCP

16 native MCP tools.

The tool set covers recall, capture, review, lifecycle, portability, backup, and health. Inputs and outputs use JSON schemas. The MCP 2026 server supports Tasks, Apps, Skills, OAuth-protected HTTP, and sealed request state. Current Hermes, Claude Code, and Codex registrations use the compatibility adapter over stdio.

memory_recallmemory_searchmemory_getmemory_remember memory_promotememory_correctmemory_supersedememory_delete memory_restorememory_review_conflictsmemory_resolve_reviewmemory_consolidate memory_importmemory_exportmemory_backupmemory_health

SETUP

Preview first. Apply after review.

Install from an authorized source checkout, then initialize the local ledger. Setup previews every target path and generated registration without writing it. Add --apply only after the preview is correct. Restart each host and verify memory_health before saving durable memory.

uv tool install .
dreamcatcher quickstart
dreamcatcher setup all
dreamcatcher setup all --apply

Repository access is required. This page does not offer a package or installer.

MACOS MANAGEMENT

A consent-based setup and management app.

The macOS app previews host and service changes before it writes. Host registration, background services, and login-item state each need explicit consent. Applied transactions receive durable receipts, so rollback and uninstall touch only state still owned by Dreamcatcher. Unknown port owners block setup instead of being replaced.

MCP HTTP127.0.0.1:8421

Memory Control Center127.0.0.1:8422

The Memory Control Center uses the same canonical MCP service and ledger. It supports scope inspection, recall debugging, conflict review, confirmed changes, audit history, tasks, health, and admin backup. The embedded MCP App provides the same operator functions through a host bridge. Run the standalone interface with dreamcatcher-control-center.

PORTABILITY

Carry an identity in a `.dream` file.

An identity artifact contains its authorized private scope, shared records, selected projects, soul, skills, and client templates. Import merges authorized data without widening scope. A system backup remains separate because restore replaces the ledger and creates a pre-restore backup. Integrity checks, deterministic packaging, and secret scanning run before publication or import.