CLI Reference

yeaboi [OPTIONS]
yeaboi <subcommand> [OPTIONS]

Subcommands

Beyond the flags below, most modes have a headless subcommand that runs the same engine the TUI card does — so anything you can do interactively you can also put in a script or a cron job.

Every subcommand takes --help. Most take --format {text,json}, and the headless ones take --strict, which exits 3 when the run was degraded (warnings present, or no data found) so a scheduled job can tell a quiet success from a quiet failure.

Agents

The Agents family reads the session logs your coding agents leave on this machine. See its docs for what is collected and what is never stored.

Interactive modes

Non-interactive / headless

Daily Standup

Session management

Configuration

Questionnaire export

🎵 Music (ffplay)

Play focus music while you plan. This is an optional integration with ffplay, the headless player bundled with ffmpeg — install it separately (brew install ffmpeg, or your platform's package manager). ffplay is used because background music has to play headlessly alongside our own full-screen TUI: interactive terminal players refuse to start without a controlling terminal, whereas ffplay -nodisp plays a stream with no UI of its own. If the ffplay binary isn't on your PATH, the feature is disabled — the status bar shows a dim ♪ music: brew install ffmpeg hint and the controls are no-ops until you install it.

Once installed, a compact player status appears on the bottom border of every screen, and two control chords work app-wide — even while typing in a text field:

Music auto-pauses while you record a voice note (double-tap Space) and resumes when the recording ends, so it never bleeds into your dictation. The on/off state and selected channel are remembered between runs. Under the hood, playback runs as a headless ffplay -nodisp process (one per stream); pause/resume suspend and continue it with SIGSTOP/SIGCONT, and it is stopped automatically when you exit.

Troubleshooting — the equalizer animates but there's no sound. The equalizer is a light animation that only means "a player was launched"; it is not driven by the audio itself. If you hear nothing, the ffplay process likely exited on its own (a stream URL that's down, or a codec the build can't decode). The status bar detects a player that exits unexpectedly and reverts to ♪ music stopped — stream unavailable, ^P to retry instead of showing a phantom "playing" state — press Ctrl+P to retry, or Ctrl+O to switch to a different stream. Confirm your ffmpeg build can play a stream directly with ffplay -nodisp https://ice1.somafm.com/groovesalad-128-mp3.

In-session commands

These commands are available at the scrum> prompt during an interactive session:

The status bar at the bottom of the terminal shows project name, current phase, and session info. It updates automatically as you progress through the pipeline.

Examples

yeaboi                                                 # interactive TUI (recommended)
yeaboi --quick                                    # quick intake (2 questions only)
yeaboi --full-intake                              # full 30-question intake
yeaboi --questionnaire intake.md                  # import pre-filled questionnaire
yeaboi --export-only --quick                      # non-interactive, auto-accept all
yeaboi --resume                                   # resume last session (picker)
yeaboi --resume latest                            # resume most recent session
yeaboi --list-sessions                            # list all saved sessions
yeaboi --clear-sessions                           # delete saved sessions
yeaboi --non-interactive --description "Build X"  # headless mode
yeaboi --non-interactive --description @brief.txt --output json  # JSON to stdout
yeaboi --dry-run                                  # TUI with mock data