superself

Superself

Superself is an Apache-2.0 CLI (npm install -g superself@0.6.1, Node 22.12+) that version-controls a project's state — goals, decisions, work units, reports — as an append-only event log in a git repository separate from the code. The state is derived on demand, so nothing in it is hand-maintained. This skill tells an agent how to read and write that state through the self CLI. It is maintained by the Superself authors: https://github.com/fxylabs/superself

When this skill applies

• The project's AGENTS.md or CLAUDE.md contains a block between <!-- superself:begin and <!-- superself:end -->, or self setup prints the workspace, project, and store this directory resolves to.
• Skip the skill when self --version fails: the project does not use Superself, and nothing below should be invented by hand. This skill is written against superself@0.6.1; a different major or minor version may have moved a verb or flag, so check self <command> --help before relying on one.