Skip to main content
Version: 0.0.14

histui Commands

Complete reference for all histui CLI commands.

Query Commands​

CommandDescription
getQuery notification history, output in various formats
appsList unique application names from history
statusOutput Waybar-compatible JSON status

Interactive​

CommandDescription
tuiLaunch interactive terminal UI

Actions​

CommandDescription
replayReplay notifications through D-Bus
setModify notification state (dismiss, seen, delete)
pruneRemove old notifications from history

Control​

CommandDescription
dndManage Do Not Disturb mode
audioControl audio playback

Common Workflows​

Browse and dismiss notifications​

histui tui

Select and replay with launcher​

histui get | fuzzel -d | histui replay

Dismiss all from an app​

histui get --filter "app=discord" --format ids | histui set --stdin --dismiss

Waybar integration​

histui status # Returns JSON for custom module

Check DnD and toggle​

histui dnd toggle

Global Flags​

These flags are available on all commands:

FlagDescription
--configPath to config file
--log-levelLog level: debug, info, warn, error
-h, --helpHelp for any command

Environment Variables​

VariableDescription
HISTUI_LOG_LEVELOverride log level
HISTUI_CONFIGOverride config file path