Quickstart

Install

npm install -g sofar.sh

The engine is MIT-licensed and free for individuals — no account required.

Start the record

In the repository you work in:

sofar init

This adds .sofar/ to the repo — the record, the agent hooks, and the protocol files — all idempotent, all versioned in git like everything else. Create an initiative for the work at hand:

sofar new my-feature

Work normally

Your agents read the record first and write back status and decisions when they stop. Claude Code is wired through hooks and MCP automatically; OpenCode, Codex, and Cursor follow the plain-text convention sofar init installs. You change nothing about how you work.

To see where any piece of work stands, from any terminal:

sofar status

Plan, progress, next action, and the decisions already settled — one read, no re-explaining.

Share it when it's a team

Teams sync the record through app.sofar.sh. Sign in once, then in your repo:

sofar login          # device flow; the token stays out of the repo
sofar link --org <your-org>
sofar push           # first push streams the record from genesis

sofar link writes a committable .sofar/remote.json, so teammates who clone later just run sofar login and sofar pull. Push after work sessions until the background watcher automates it.

During the pilot, orgs are created by us — write to hello@sofar.sh to join as a design partner.