A braille-dot progress bar for statuslines and terminals.
dotbar 76 ⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⣀⣀⣀ 76% (13 cells, 1% per dot)
dotbar --dense 76 ⣿⡿⣀ 76% (3 cells, 5% per dot)
dotbar demo animate 0 -> 100% over 5s
dotbar demo-slow animate 0 -> 100% at 1%/s
With no percent argument it reads Claude Code statusline JSON on stdin and
renders 100 - .context_window.remaining_percentage. No such field means no
output and exit 0, so a statusline segment with no data vanishes rather than
printing an error.
Cells ramp green to red left to right. NO_COLOR=1 drops every escape
sequence, for consumers that render the output as literal text.
Any other first argument is dispatched git-style to dotbar-<subcommand>,
preferring a sibling of the dotbar binary over $PATH.
brew install tlehman/tap/dotbar
The tap's formula is kept in this repo at
packaging/homebrew/dotbar.rb; the tap repo is
tlehman/homebrew-tap, and brew install --HEAD tlehman/tap/dotbar builds
main.
makepkg -si -D packaging/arch
Omarchy is Arch, so one package covers both. The PKGBUILD is kept in this repo
at packaging/arch/PKGBUILD; it builds the tagged
release with the system Rust toolchain (cargo, pulled in as a makedepend) and
runs the test suite as its check(). Publishing it to the AUR means copying
that file to the dotbar AUR repo along with makepkg --printsrcinfo > .SRCINFO.
Or from source, which needs a Rust toolchain (brew install rust):
cargo install --git https://github.com/tlehman/dotbar
Run it directly or add it as a flake input:
nix run github:tlehman/dotbar -- 76
inputs.dotbar.url = "github:tlehman/dotbar";
# then: inputs.dotbar.packages.${system}.defaultWire dotbar into Claude Code's statusline:
dotbar install-claude
It shows the exact statusLine entry it will add to ~/.claude/settings.json
(or $CLAUDE_CONFIG_DIR/settings.json) and asks before writing. An existing
statusline command is kept, with the bar prefixed on the same line. Pass
--dense for the 3-cell bar and --yes to skip the prompt; the old file is
saved as settings.json.bak.
devenv shell (trust once with devenv allow), then devenv test for the
full contract: toolchain present, cargo clippy -D warnings, cargo test.
Panic-capable constructs are denied in production code (Cargo.toml
[lints.clippy]) and allowed in tests (clippy.toml).
MIT OR Apache-2.0.