Skip to content

v0.5.1 — an agent reads every feature from the installed CLI

Choose a tag to compare

@tonite31 tonite31 released this 04 Aug 09:49
· 132 commits to main since this release

An agent working in a project can reach the managed block and the installed binary. This release makes that enough.

npm install -g superself

self help <topic>

Seven concept pages, shipped in the binary:

topic answers
agents how a session drives this CLI, start to finish
context what self context renders, and why something is missing from it
records one entity behind every record kind, and how a record is corrected
placement scope, priority and exposure — how a record earns its place in context
work the work graph: outcomes, evidence, criteria, and proposals
goals the long-term goal, objectives, milestones, and what reaching one takes
workspace the store, the projects in it, and moving it between machines

self lists them, so they are found without being announced. A subject a command already owns keeps one page: self help work prints the syntax and then the concept.

Until now --help said how to type a command and never when to reach for it — a reader of state place <id> [--exposure full|index|search] had the whole syntax and still did not know what exposure was.

A shorter managed block

The block written into AGENTS.md and CLAUDE.md is loaded every session, so it has to stay short. It keeps every rule that changes what a session does — read context, attach work, evidence-gated done, how a correction is spelled, decisions, blocked and retired units, register approved work, briefs on deferred work, merge control — and hands the rest to a topic. Its pointers render from the topic list, so it cannot name a page that does not exist.

The block says which CLI wrote it

<!-- superself:begin v0.5.1 -->

The block is rewritten by whatever binary a machine has. Without a stamp, an older CLI silently rewrites a newer block and two machines' commits disagree with nothing to point at. Blocks are found by the marker's prefix, so one written before this release is recognised and replaced in place — your existing projects need no migration, and the block comes forward on the next thing they record.

Full changelog: v0.5.0...v0.5.1