Skip to content

v2026.9.1

Latest

Choose a tag to compare

@extsoft extsoft released this 02 Sep 04:00
3680188

Document Homebrew as an install path

The Pages install guide listed the script, mise, and go install, but not
Homebrew. macOS and Linux users can now install from the extsoft/tools
tap, with go install kept as the last option. After a GitHub release the
formula is bumped from that tap, not from this repository.

Fold workspace status into list command

Listing workspaces and showing the one linked to this repository
were two commands for the same question at different scopes. List
now treats current and all as selectors, and defaults to current
inside a git work tree so the usual case needs no extra argument.

The old status command still works with a warning until it is
removed. Workspaces cannot be named all or current, so those
selectors stay unambiguous.

Rename remaining status commands to list

Inspect actions on memory, git, repo, and hook were still called
status, which clashed with native git status and did not match
workspace and work list. Those actions are now list. The old names
stay as hidden shims that warn (DEP-018) until they are removed.

hook list still runs existing hook-status scripts so those files
keep working. repo list now shows the current repository, not the
full catalog; that catalog remains memory repositories.

Align descriptions in the help catalog

The top-level help listed each action with the object name again and
padded that combined string to a fixed width. Short names picked up
extra spaces and longer ones sat flush against the description, so the
catalog was hard to scan.

Actions now appear under the object heading only, and every description
in that catalog starts in the same column. Flag lines use the same
alignment so the spacing stays consistent.

Fold git and memory into the self object

Git and memory were extra objects for the installation and for
catalogs of workspaces and repositories. That split fought the CLI
model: the tool itself is one thing, and catalogs belong on the
objects they list. Configure, list, and doctor now live on self;
workspace and repo list take the catalogs, with current versus all
selectors like the rest of those commands.

The old git and memory names remain as hidden shims (DEP-019), and
repo doctor rewrites hook files that still use git-* ids. List
output is the same shape on every object: colored headings, nested
fields, and further steps where they help. Work list keeps git's
own colors and spacing so status, log, and stash look like git
itself.

Organize the docs around CLI objects

The old Guides section mixed objects with topics like pipes, and every
action lived in one Reference table. Looking up a single command meant
hunting. The site now has a chapter per object with a page per action,
CLI anatomy up front, and non-object topics in Reference. A Cursor rule
records the house style so later edits stay consistent.