Bar Integrations

--bar-json is a shared status-bar contract rather than a single command. Tools emit one-line --bar-json output (with text, tooltip, and class fields) meant to be polled by a status bar module through its own short-lived cache. Left click opens the relevant TUI; right click refreshes the cache.

The JSON format is bar-agnostic: it works with Waybar, Quickshell, or any bar that can run a command and parse JSON. My own setup uses Waybar, so the bundled modules and dot doctor checks target Waybar, but the commands themselves do not depend on it.

dot commands with bar output

Status & Diff dot git-diff --bar-json flags managed repos that have uncommitted or unpushed changes.

Workflow Runs dot git-workflows --bar-json --since surfaces recent GitHub Actions activity for each repo's checked-out commit.

Notifications dot git-notifications --bar-json shows the GitHub notification inbox; left click opens the filtered TUI.

The command reference lists the full --bar-json flag set on each command.

External applications

--bar-json is not limited to dot. Other tools in this setup emit the same bar-friendly JSON, so one bar can poll them the same way. go-automate is one example: its --bar-json reference documents the Home Assistant watcher output it exposes to a status bar.

Configuration

Which repos and which activity reach the bar is controlled by the private dot-git.yml config; the notifications.bar.ignore_bot_activity key tames bot noise. See Private Git Config.

Health checks

dot doctor verifies the active status-bar module wiring for git-workflows and git-notifications, alongside dot-git.yml and the absence of legacy git-workflow-watch leftovers.