Commands overview

Running buzz with no arguments launches the interactive TUI. Every common action is also available as a one-shot subcommand that prints plain output and exits — ideal for scripts, cron jobs, and status bars.

Command index

Viewing goals

Command	Description
buzz next	Terse summary of the next due goal
buzz list	List all goals with a summary overview
buzz today	All goals due today
buzz tomorrow	All goals due tomorrow
buzz due	Goals due within a duration you specify
buzz less	All do-less type goals
buzz view	Detailed information about a goal
buzz data	List a goal’s datapoints
buzz schedule	Deadline distribution across a 24-hour day
buzz review	Interactive review of all goals

Managing goals

Command	Description
buzz add	Add a datapoint to a goal
buzz refresh	Refresh autodata for a goal
buzz charge	Create a charge on your account
buzz deadline	Change a goal’s deadline
buzz ratchet	Remove safety buffer from a goal
buzz archive	Schedule a goal for archive
buzz auth login	Authenticate with Beeminder

Global flags

--no-color

If you prefer plain text output without colors, use the global --no-color flag with any command:

buzz --no-color next
buzz --no-color today
buzz --no-color view mygoal
buzz --no-color            # Even works with the TUI

The flag can be placed anywhere on the command line and works with all buzz commands. This is useful for:

• Terminal environments with limited color support
• Scripts or automation where colored output is not desired
• Screen readers or accessibility tools
• Logging output to files

--account

With more than one account configured, every command shows goals from all of them. --account <username> narrows a single invocation to one:

buzz --account bob today
buzz --account bob add read 30

It scopes reads and writes alike, and can be placed anywhere on the command line. An unconfigured username is rejected rather than silently ignored.

To act on one goal without scoping the whole command, qualify its slug instead: buzz add bob/read 30.

Urgency colors

Commands that list goals color-code each one by deadline urgency, using the same scheme as the TUI grid:

Color	Meaning
Red	Overdue or due today (safebuf < 1)
Orange	Due within 1 day (safebuf < 2)
Blue	Due within 2 days (safebuf < 3)
Green	Due within 3–6 days (safebuf < 7)
Gray	Due in 7+ days