Repository navigation
v1.23.18
-
Fleet hops call peers by the canonical
psanddaemon indexspellings (PHNX-4227).
A session on another device is now stopped there withagents ps stop <id> --local
and detached withagents ps detach <id> --local, the fleet roster asks each peer
foragents ps --local --json, andbackfill tools --fleet/--devicedrives
each peer withagents daemon index backfill tools --json --localplus the same
filters. Each peer must run the release that carries this change.
An older peer is not detected or worked around: its roster and backfill rows
read as unreachable, and a stop or detach prints the peer's own unknown-command
error. Source:
cli/src/commands/sessions-stop.ts,cli/src/commands/detach.ts,
cli/src/lib/session/remote-active.ts,cli/src/commands/sessions-backfill.ts. -
agents browser,agents computer,agents secretsandagents sessionsare removed (PHNX-4227, owner decision 2026-10-12).
There is no alias, passthrough or forwarder. Each exits 1 with one line naming
what to run instead, including under--help:
error: 'agents browser' was removed; use the standalone 'browser' CLI (browser --help).
Call the standalonebrowser,computer,secretsandsessionsCLIs directly
(agents setup toolsinstalls the pinned releases). Thesessionsverbs that
agents-cli owned have homes of their own, and the refusal names them:
sessions resume→agents run auto --resume <id>,sessions --active→agents ps,
stop/focus/detach/migrate/migrations/preview→agents ps <verb>,
watch→agents ps watch --json,inject→agents send --channel session,
fork→agents fork(now listed in--help),backfill/optimize/--roots→
agents daemon index,stats→agents insights resources,insights→
agents insights,backup-setup→agents setup session-backup.
Source:cli/src/lib/startup/command-registry.ts,cli/src/bootstrap.ts. -
Fleet peers are asked with the new spellings, so every device needs this release.
Selector resolution (whatagents run --resume <id>,ps focusandps preview
use to find a session on another box) asks the hiddenagents ps resolve <selector> --json --local; launch-id lookup after a--devicedispatch asksagents ps resolve --launch-id <id>; remote previews askagents ps preview <id> --local --json; the
fleet session stream asksagents ps watch --json --local. The session picker's
history pool now asks each peer's standalonesessions --all --json --local. A peer
on an older agents-cli answers with an unknown command and reads as unreachable until
it updates (auto-update runs within 24 hours).
Source:cli/src/commands/ps.ts,cli/src/lib/session/selection.ts,
cli/src/lib/session/remote/watch.ts,cli/src/commands/sessions-browser.ts. -
Session rows recover with
agents ps focus <id>. Therecoverycommand on
agents ps watch --jsonandagents feed watch --jsonrows was
agents sessions resume <id> --device <owner>; it is nowagents ps focus <id>,
which attaches a live pane or recovers an ended session on its owning device.
Source:cli/src/lib/session/remote/watch.ts,cli/src/lib/session/projection.ts. -
devices.<name>.computer.hostis removed with theagents computer --device
path that read it. Drive another desktop withcomputer <verb> --host <address>.
Source:cli/src/lib/device-config.ts,cli/src/lib/computer-client.ts. -
Help, prompts and scripts name the commands that exist.
--helpforrun,
trace,forkand every-D/--deviceoption no longer points atagents hosts
or the removed groups. Agent-facing text
(the watchdog nudge, the migrate rehydrate prompt, the rotate resume prompt) now
sayssessions <id>to read a transcript, and the release and CI scripts call
secrets execdirectly. -
The
agents pspicker'sykey copies a command that runs. It copied
ag sessions …; a running or status view now copiesagents pswith its
--status,-D,--bookmarksand--routineflags, and a history view copies
the standalonesessions …with its filters.
Source:cli/src/commands/sessions-browser.ts. -
Owner notifications no longer have quiet hours. rush/api dropped quiet hours
and the notification timezone, so the CLI no longer sends asettingsobject to
PUT /me/preferencesand no longer reports aquiet_hourssuppression. The
one-timehumans.yamlupload listsquietHours,quiet_hoursandtimezone
under "not migrated" instead of uploading them. Source:
cli/src/lib/owner-notify.ts,cli/src/lib/installations/migrate.ts.