Skip to content

hype log

Log a new win/achievement.

Terminal window
# Interactive mode (walks you through space, tags, and date)
hype log
# Direct mode
hype log <text> [options]

Run hype log with no arguments for an interactive experience, or pass options directly.

ArgumentRequiredDescription
textNoWhat you accomplished. Use - or pipe text in to read stdin; omit in a terminal for interactive mode
OptionTypeDefaultDescription
-s, --space <name>stringN/ASpace to log the win in (case-insensitive)
-t, --tags <tags>stringN/AComma-separated tags (e.g. impact,product)
-d, --date <date>stringtodayDate of the win (YYYY-MM-DD)
Terminal window
# Basic win
hype log "Fixed the login bug"
# Win with space and tags
hype log "Launched the new pricing page" --space Work --tags launch,frontend
# Backdate a win
hype log "Gave a talk at the conference" --space Personal --date 2026-02-28
# Pipe text in
git log -1 --format=%s | hype log --space Work --tags shipped
# Print the created win as JSON
hype log "Closed the Q4 deal" --space Work --json
  • The body is sent as markdown format automatically
  • Space names are matched case-insensitively: work, Work, and WORK all match the same space
  • If the space is not found, the CLI shows available spaces and exits with an error
  • Without --space, the win goes to your only writable space. If you have several, hype log asks in a terminal; in scripts, pass --space or set HYPEDOC_DEFAULT_SPACE (or default_space in the config file)
  • The date defaults to today in UTC and cannot be in the future
  • Tags are created automatically if they don’t exist yet