Skip to content
TakoAPI
Back to skills

agent-wal

by bowen31337

Notes & PKM
827Downloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Write-Ahead Log protocol for agent state persistence.

Description

What This Skill Does

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.

When to Use It

  • 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

Example Workflow

INPUT

User says: 'No, use Podman not Docker for all tooling'

AGENT
  1. 1

    Runs wal.py append agent1 correction 'Use Podman not Docker for all tooling' before responding

  2. 2

    Confirms entry is written to the JSONL WAL file at ~/clawd/memory/wal/agent1.wal.jsonl

  3. 3

    Responds to the user with the corrected behavior applied

  4. 4

    On next session start, runs wal.py replay agent1 to surface unapplied entries

  5. 5

    Marks the entry as applied after incorporating it into context

OUTPUT

Correction persisted to disk and restored at the next session start, with no manual re-statement needed from the user

Installation

clawhub install bowen31337/agent-wal

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links