Command-line usage

Updated Jan 30, 2026

The q command operates on explicit topics:

  • q put [topic] opens $EDITOR and enqueues a message. If no topic is supplied, the first line of the editor text is treated as the topic.
  • q readto [topic] reads from stdin and enqueues the message.
  • q get <topic> dequeues the first message. With --block, polling continues until a message exists.
  • q peek <topic> [uuid] prints a message without removing it.
  • q list <topic> lists messages with UUIDs and summaries.
  • q del <topic> <uuid> deletes a message by UUID.
  • q edit <topic> <uuid> edits a message using $EDITOR.
  • q replace <topic> <uuid> replaces content from stdin.

The git-q command derives the topic from the current git repository's remote:branch and exposes the same core actions:

  • git-q put
  • git-q readto
  • git-q get (use --block to poll)