histui Commands
Complete reference for all histui CLI commands.
Query Commands
| Command | Description |
|---|---|
| get | Query notification history, output in various formats |
| apps | List unique application names from history |
| status | Output Waybar-compatible JSON status |
Interactive
| Command | Description |
|---|---|
| tui | Launch interactive terminal UI |
Actions
| Command | Description |
|---|---|
| replay | Replay notifications through D-Bus |
| set | Modify notification state (dismiss, seen, delete) |
| prune | Remove old notifications from history |
Control
| Command | Description |
|---|---|
| dnd | Manage Do Not Disturb mode |
| audio | Control 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:
| Flag | Description |
|---|---|
--config | Path to config file |
--log-level | Log level: debug, info, warn, error |
-h, --help | Help for any command |
Environment Variables
| Variable | Description |
|---|---|
HISTUI_LOG_LEVEL | Override log level |
HISTUI_CONFIG | Override config file path |