Skip to content
tlehmanPublic

About

Braille-dot progress bar for statuslines and terminals

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

dotbar

A braille-dot progress bar for statuslines and terminals.

dotbar demo

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.

Install

Homebrew

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.

Arch Linux / Omarchy

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.

Rust

Or from source, which needs a Rust toolchain (brew install rust):

cargo install --git https://github.com/tlehman/dotbar

Nix

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}.default

Claude Code statusline

Wire 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.

Developing

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).

License

MIT OR Apache-2.0.

About

Braille-dot progress bar for statuslines and terminals

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages