State
Goals, active decisions, and open questions — kept small, current, and append-only.
Git versions your code. Superself versions the project itself — goals, decisions, work, and outputs — so every session picks up where the last one left off.
~/app $ self init
✓ workspace created — state store versioned with git
~/app $ self goal set "Iterate the CLI toward a published superself package"
✓ goal updated
~/app $ self decide "Sync is explicit only — no per-event push" --why "keeps events fast"
✓ decision recorded
~/app $ self work add "Commit-trailer harvesting turns commits into events"
✓ work created · w-9ce8e
~/app $ self work
w-9ce8e active Commit-trailer harvesting turns commits into events
w-vk8td active Context size budget decided from real measurements
w-n97w6 blocked The viewer legibly expresses the core value of self
w-5k1sg next Any checkout of a registered project resolves itself
(25 done — see log)
~/app $ self context
# superself — version control for your project's state
Goal: Iterate the CLI toward a published superself package
## Decisions — 33 active, append-only history
## Work in progress — w-9ce8e · commit-trailer harvesting
→ ready for any agent, any session, any tool
Goals, active decisions, and open questions — kept small, current, and append-only.
Every unit has an identity, a state, a current report, and its revision history.
Artifacts stay connected to the work that produced them, across sessions and tools.
self view opens a live workspace viewer — goals, decisions, work, and artifacts, all derived from state instead of hand-maintained notes.
Pick your accent: violet, cyan, orange, or mono.
self view →d-0142SETTLEDw-0067IN PROGRESSw-0065DONEfoldLIVETurn any directory into a workspace with its own state store and git history.
Typed verbs — decide, work, report — instead of rotting markdown notes.
Derived context is generated from state, so each session starts where the last one ended.