agent-wal
oleh bowen31337
Notes & PKMRingkasan
Write-Ahead Log protocol for agent state persistence.
Deskripsi
Apa yang Dilakukan Skill Ini
Write-Ahead Log protocol for persisting agent state to disk before responding. Prevents corrections, decisions, and context from being lost when conversations are compacted. Entries are stored as append-only JSONL and can be replayed at session start to restore lost context.
Unlike relying on in-memory context alone, WAL entries persist to disk and survive compaction, so corrections made early in a session are not silently discarded.
Kapan Menggunakannya
- Preserving a user correction across a session restart
- Logging an architectural decision before continuing a long conversation
- Flushing buffered context before anticipated compaction
- Replaying missed corrections at the start of a new agent session
- Batching state changes during a complex multi-step task
Contoh Alur Kerja
User says: 'No, use Podman not Docker for all tooling'
- 1
Runs
wal.py append agent1 correction 'Use Podman not Docker for all tooling'before responding - 2
Confirms entry is written to the JSONL WAL file at ~/clawd/memory/wal/agent1.wal.jsonl
- 3
Responds to the user with the corrected behavior applied
- 4
On next session start, runs
wal.py replay agent1to surface unapplied entries - 5
Marks the entry as applied after incorporating it into context
Correction persisted to disk and restored at the next session start, with no manual re-statement needed from the user
Instalasi
clawhub install bowen31337/agent-walJalankan perintah CLI-nya, atau tempel prompt ke Claude Code, Cursor, Codex, atau coding agent apa pun yang Anda pakai.