Repository navigation
v0.5.1 — an agent reads every feature from the installed CLI
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