Command Syntax

Version 0.1.0 Updated Jun 28, 2026

Run catnap with one or more duration operands:

catnap NUMBER[SUFFIX]...

Each operand is a non-negative decimal number with an optional suffix:

  • s for seconds, which is also the default when no suffix is supplied.
  • m for minutes.
  • h for hours.
  • d for days.

Multiple operands are summed, matching GNU sleep style:

catnap 1m 5s

The command accepts --help and --version. Invalid operands, missing operands, unsupported suffixes, and unknown options are reported to standard error with a non-zero exit status.