Skip to content

v0.2.0 — TurnState: always-on memory

Choose a tag to compare

View all tags
@tonydzi tonydzi released this 28 Jun 10:07
· 28 commits to main since this release
v0.2.0
c24653a

v0.2.0 — first runnable module.

CharmOS ships its first real code: modules/turnstate/, the always-on memory pillar from the manifesto.

TurnState gives an AI coding/agent session a durable, queryable working memory without spending a single LLM token to maintain it. After each turn it writes one deterministic row (ask · summary · files · tools · commands · decisions · evidence pointer) to a local SQLite ledger.

Two halves:

  • turnstate_hook.py — real-time Stop-hook fast path. Pure stdlib, never raises into the session.
  • turnstate_backfill.py — idempotent rebuild straight from transcripts + a --check freshness gate, so the ledger can never silently rot.

The raw transcript stays the source of truth; TurnState is the cheap derived index you recall against. Local-only, no data leaves your machine. See modules/turnstate/README.md.

Full notes in the CHANGELOG.

Assets 2
Loading