Early alpha · Apache-2.0 · local-first

Version control for
your project's state.

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.

$ npm install -g superselfCOPY
~/app — selfinitdecideworkcontext

~/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

State

Goals, active decisions, and open questions — kept small, current, and append-only.

Work

Every unit has an identity, a state, a current report, and its revision history.

Outputs

Artifacts stay connected to the work that produced them, across sessions and tools.

See the whole project at a glance.

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 →
workspacedecisionsworkartifacts
Ship the open-source CLI firstd-0142SETTLED
Landing page redesign for OSS launchw-0067IN PROGRESS
Event schema v2 migrationw-0065DONE
Derived context regeneratedfoldLIVE
01

init once

Turn any directory into a workspace with its own state store and git history.

02

record as you go

Typed verbs — decide, work, report — instead of rotting markdown notes.

03

every agent catches up

Derived context is generated from state, so each session starts where the last one ended.

Your agents forget. Your projects shouldn't.