# bus

> Direct interface to the MirrorDNA Memory Bus — the single source of truth for system state. Supports read, health, history, intent, and write subcommands. The bus is identity; always read before acting, always write before ending.

- Author: Paul
- Repository: MirrorDNA-Reflection-Protocol/mirrordna-skills
- Version: 20260127132112
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/MirrorDNA-Reflection-Protocol/mirrordna-skills
- Web: https://mule.run/skillshub/@@MirrorDNA-Reflection-Protocol/mirrordna-skills~bus:20260127132112

---

---
name: bus
description: Direct interface to the MirrorDNA Memory Bus — the single source of truth for system state. Supports read, health, history, intent, and write subcommands. The bus is identity; always read before acting, always write before ending.
metadata:
  author: mirrordna
  version: "1.0"
  category: state
---

# Memory Bus Operations

Direct interface to the MirrorDNA Memory Bus.

## Arguments

- `read` (default): full state read
- `health`: quick health check
- `history`: session history (who wrote what)
- `intent`: show binding constraints
- `write [message]`: write to bus with message

## Steps

### Read
```bash
~/.mirrordna/bin/bus read
```

### Health
```bash
~/.mirrordna/bin/bus health
```

### History
```bash
~/.mirrordna/bin/bus history
```

### Intent
```bash
~/.mirrordna/bin/bus intent
```

### Write
```bash
echo '{"state":{"phase":"[inferred from context]"}}' | ~/.mirrordna/bin/bus write "[message]" --json
```

Or via Python for complex writes:
```python
from lib.memory_bus import MemoryBus
bus = MemoryBus()

with bus.write_transaction("[message]", writer="claude_code") as txn:
    txn.update_state({"phase": "[new phase]"})
    txn.remove_pending("[completed item]")
    txn.append_notes("[details]")
```

## Rules

- The bus is the single source of truth — not handoff.json, not chat history
- Always read bus at session start
- Always write to bus before session ends
- Never write handoff.json directly — it's auto-generated from bus

## Output Format

```
⟡ Bus: [subcommand]

[raw bus output, formatted]
```