Ray's Knowledge Base

rkb prints human text by default, and agents pass --toon

DecisionVerified 27 Sep 2026Holds project: rkb
Decision. The context, the choice, why, and the options that were turned down.

Context#

rkb first printed TOON whenever stdout was not a terminal, so a person piping it into less or a file got TOON.

Decision#

The default is human text, also when piped; --toon (the same as --format toon) gives TOON, and --format json is for scripts. The skill, the command prompts and the session-start line tell agents to pass --toon on every call; the agent tools always return TOON.

Why#

The user wanted the CLI to suit people by default and agents to ask for TOON explicitly.

Rejected options#

  • TOON whenever stdout is piped: surprises people who pipe the output.