Collapse the human CLI surface into bare compose #25

Closed
opened 2026-07-23 00:52:34 +00:00 by coilyco-ops · 2 comments
Member

Kai's UX feedback: --help lists too many commands. Bare agent-compose compose converges the host (roster artifact + cascade); compose <request.kdl> keeps making bundles. cascade/roster/project stay functional but hidden from help. New optional config key roster_sources feeds personality bodies to convergence. Visible surface: compose, launch, describe, diff, version.

Filed by Claude Code on Kai's direction.

Kai's UX feedback: --help lists too many commands. Bare `agent-compose compose` converges the host (roster artifact + cascade); `compose <request.kdl>` keeps making bundles. cascade/roster/project stay functional but hidden from help. New optional config key roster_sources feeds personality bodies to convergence. Visible surface: compose, launch, describe, diff, version. Filed by Claude Code on Kai's direction.
Author
Member

Shipped in cb93425, released as v0.3.0 (brew/scoop bumped), live on Kai's workstation.

Bare agent-compose compose converges the host: roster artifact refreshed from the new roster_sources config key (added to the live yaml, pointing at the fixture skills until #10), then the cascade. compose <request.kdl> unchanged for bundles. cascade/roster/project hidden but functional for scripts, ward, and #17. Visible help: compose, launch, describe, diff, version. Tested: converge happy path, no-config no-op, bad-roster-source degradation.

Closed by Claude Code working the issue queue.

Shipped in cb93425, released as v0.3.0 (brew/scoop bumped), live on Kai's workstation. Bare `agent-compose compose` converges the host: roster artifact refreshed from the new roster_sources config key (added to the live yaml, pointing at the fixture skills until #10), then the cascade. compose <request.kdl> unchanged for bundles. cascade/roster/project hidden but functional for scripts, ward, and #17. Visible help: compose, launch, describe, diff, version. Tested: converge happy path, no-config no-op, bad-roster-source degradation. Closed by Claude Code working the issue queue.
Author
Member

Follow-up shipped in d13abaf (v0.4.0, breaking): launch absorbed into compose behind the -- terminator, per Kai's direction.

  • compose <request.kdl> --layout X [--target d] [--out d] -- : bundle refresh + projection, then exec (the former launch).
  • bare compose -- : full host convergence (roster + cascade), then exec - the natural wrapper form.
  • Sentinel recursion guard rides both paths; smoke-verified including nested skip.
  • The launch verb is gone; visible surface is now compose, describe, diff, version. docs/launch.md and the wrapper installation requirements updated to the compose invocation.

Filed by Claude Code working the issue queue.

Follow-up shipped in d13abaf (v0.4.0, breaking): launch absorbed into compose behind the -- terminator, per Kai's direction. - compose <request.kdl> --layout X [--target d] [--out d] -- <cmd>: bundle refresh + projection, then exec (the former launch). - bare compose -- <cmd>: full host convergence (roster + cascade), then exec - the natural wrapper form. - Sentinel recursion guard rides both paths; smoke-verified including nested skip. - The launch verb is gone; visible surface is now compose, describe, diff, version. docs/launch.md and the wrapper installation requirements updated to the compose invocation. Filed by Claude Code working the issue queue.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
coilyco-flight-deck/agent-compose#25
No description provided.