Skip to content

CLI Hint Sentinel Format

Bullpen CLI validates command hints in source code before release. To make that possible, internal hint strings wrap runnable commands in sentinel markers:

<<RUN: bullpen polymarket discover>>
<<TRY: bullpen polymarket approve>>

RUN means the command is the recommended next step. TRY means the command is a tentative recovery step.

User-facing CLI output should strip the wrapper and show only the inner command, for example:

bullpen polymarket discover

If an agent or script sees a raw sentinel in stdout or stderr, interpret only the inner bullpen ... command. Do not pass the <<RUN: or <<TRY: wrapper back to a shell. A leaked sentinel is a CLI display bug; please report it at github.com/BullpenFi/bullpen-cli-releases/issues with the command that produced it.

The public command path inside a sentinel is still expected to be valid. Bullpen's test harness checks those paths against live CLI help output.