Chronicle is a POSIX-compliant FUSE filesystem that provides versioned file access for agent workspaces. Every file modification creates an iteration (version), enabling temporal queries, content deduplication, and bidirectional replication between agent hosts and sandboxes.

​
What It Does

  • Mounts as a standard POSIX filesystem — agents read and write files normally
  • Versions every file modification as an iteration with timestamp and metadata
  • Deduplicates content via BLAKE3-based content-addressable storage (CAS)
  • Replicates filesystem state bidirectionally between agent hosts and sandboxes
  • Persists to S3 for durability and cross-agent content sharing

​
Key Properties

PropertyDetail
LanguageRust
FUSE Backendfuser (macFUSE) or native FSKit (macOS 15.4+)
DatabaseSQLite (metadata) + BLAKE3 CAS (content)
HashingBLAKE3 (content-addressable storage)
ReplicationUnix socket or WebSocket, bincode wire protocol
CompressionZstd for CAS storage
ChunkingLarge files split into chunks for parallel transfer
FilteringGitignore-compatible pattern matching

​
How Agents Use It

Chronicle is transparent to agents. They just use normal file operations: TypeScript agent: 
const workspace = process.env.AGENT_WORKSPACE;
// Files written here are automatically versioned by Chronicle
await Bun.write(`${workspace}/output.ts`, generatedCode);
Python agent: 
workspace = Path(os.environ['AGENT_WORKSPACE'])
(workspace / 'output.py').write_text(generated_code)

​
Architecture

Agent Process
     │
     │ Normal POSIX file I/O (open, read, write, etc.)
     ▼
┌──────────────┐
│   Chronicle   │  FUSE filesystem
│ (fuser/FSKit) │
└──────┬───────┘
       │
  ┌────┴────────────────────┐
  │                         │
  ▼                         ▼
SQLite DB              CAS Store
(metadata,            (BLAKE3 hashed
 iterations,           content files,
 directory tree)       Zstd compressed)
       │                    │
       │                    ▼
       │              ┌──────────┐
       │              │  S3 CAS  │  (optional tiered storage)
       │              └──────────┘
       │
       ▼
  Replication
  (Unix socket / WebSocket)
       │
  ┌────┴────┐
  │ Sandbox  │  Remote Chronicle instance
  │ Instance │
  └─────────┘