Problem
The spinner in the gestate command (and likely other commands) is great for human terminals but eats context in Claude Code sessions. Animated output, ANSI escape sequences, and spinner frames get captured as literal characters in the conversation context — noise that crowds out useful signal.
Proposed Solution
Add a --quiet (or -q) flag to the main koad-io wrapper that suppresses:
- Spinners / progress animations
- ANSI color codes and escape sequences
- Any decorative / flashy output
In quiet mode, commands should still emit meaningful status lines (what's happening, what completed, what failed) — just no animation or decoration.
Usage
koad-io --quiet gestate mercury
koad-io -q install nodejs
Or via environment variable so entities can set it once in .env:
KOAD_IO_QUIET=1 koad-io gestate mercury
Why
When Juno or Vulcan run koad-io commands inside a Claude Code session, every spinner frame and escape sequence lands in the context window. The context should be pointed at the work, not at decorative terminal output.
The --quiet flag lets AI sessions stay clean without breaking the human terminal experience.
Acceptance Criteria
Problem
The spinner in the
gestatecommand (and likely other commands) is great for human terminals but eats context in Claude Code sessions. Animated output, ANSI escape sequences, and spinner frames get captured as literal characters in the conversation context — noise that crowds out useful signal.Proposed Solution
Add a
--quiet(or-q) flag to the mainkoad-iowrapper that suppresses:In quiet mode, commands should still emit meaningful status lines (what's happening, what completed, what failed) — just no animation or decoration.
Usage
Or via environment variable so entities can set it once in
.env:Why
When Juno or Vulcan run
koad-iocommands inside a Claude Code session, every spinner frame and escape sequence lands in the context window. The context should be pointed at the work, not at decorative terminal output.The
--quietflag lets AI sessions stay clean without breaking the human terminal experience.Acceptance Criteria
--quiet/-qflag recognized by the main wrapper before dispatching to subcommandsKOAD_IO_QUIET=1env var as an alternative