CLI

honed sessions [--index PATH] COMMAND      (alias: honed s)

The index defaults to $HONED_INDEX, else ~/.honed/learning.sqlite. It keeps sessions and the reflections on them (/reflect, /evolve): unlike the sessions, which are read again from their transcripts, reflections live only there.

Command Does
add PATHS… [--harness H] [--format native\|dataclaw] [--source-id ID] [--no-sync] Register transcript directories and synchronize them.
sources Show registered sources.
sync [--source-id ID] Read new and changed transcripts.
list [--harness H] [--since T] [--until T] [--json] Indexed sessions, newest first.
search [TEXT] [--mode literal\|lexical] [--kind K] [--tool T] [--status S] [--json] Events matching text and filters.
show EVENT_ID [--context N] An event with its surrounding events.
trajectories SESSION (alias t) A session's trajectories.
render [SESSION] [--trajectory N] [--through] [--format F] [--best-effort] Markdown, or a harness's transcript format.
install [REFERENCES…] --to H [--trajectory N] [--through] [--all] Install sessions where a harness can resume or fork them.
trace RUN A run's sub-agent runs and delegations.
honed report WORKSPACE [-o report.html] [--ref BRANCH …] [--reflections DIR]

Writes the evolution report of a workspace.

honed agent install --repo URL|PATH --harness H [--version VERSION] [--project DIR | --global] [--force]
honed agent uninstall --name NAME --harness H [--project DIR | --global]

Installs an AgentConfig from its workspace repository (--repo, or its spellings --url and --path: a git URL is cloned to a temporary folder), at the release --version names (its release/<version> branch; default main). --project (the default, with the current folder) installs into the harness's project layout; --global into the harness's own folder for every project: ~/.claude (or $CLAUDE_CONFIG_DIR), ~/.codex (or $CODEX_HOME), ~/.pi/agent, ~/.config/opencode. The install record goes beside what was installed, so reinstalling replaces exactly what the last install wrote. A global install for Claude skips MCP servers (Claude keeps them in ~/.claude.json), and hook scripts run by their absolute path. --force overwrites files the agent's earlier installs did not write.

honed setup [DIR] [--harness H] [--ignore PATTERN …] [--remote URL | --create-remote [OWNER/NAME] | --local]
            [--no-git-init] [--no-commit]
honed skills install self-evolve [--project DIR] --harness H [--runtime H] [--ignore PATTERN …] [--remote URL]
honed skills uninstall self-evolve [--project DIR]
honed evolve [--project DIR] [--json] [--recipe FILE] [--open] [--estimate]
honed evolve diff | amend -m WHY | apply [--push/--no-push] | discard | status | ignore PATTERN… [--remove] | rollback VERSION
honed evolve init | remote URL

Set a project up for /evolve, and run its rounds. honed setup does the whole setup in one step (git init if needed, the harness detected, a commit of what it installed); skills install self-evolve is the install alone.

honed skills install reflect (--project DIR | --global) --harness H [--harness H …]
honed skills uninstall reflect [--project DIR | --global] [--harness H …]

/reflect on its own, for a project or, with --global, for every project (into the harness's own folder, as agent install --global). /evolve itself is per project: its workspace and sessions belong to one project.

Run any command with --help for every option.