octoscope
Your GitHub profile as a live terminal dashboard
Start new thread
Giovambattista Fazioli

octoscope 0.8 — your GitHub TUI is now configurable, your way

by
octoscope
•

octoscope is configurable now. v0.8 lands the configuration story we've been building toward — split across two patches but one product idea: octoscope should adapt to your habits, not the other way around.

Three things changed:

  • `~/.config/octoscope/config.toml`: set `refresh_interval`, hide private items by default with `public_only`, opt into a denser card layout with `compact`. CLI flags `--refresh 30s`, `--compact`, `--public-only` and `--config PATH` override the file when you want a one-off run.

  • In-app settings panel — press `,` (comma) while running and a panel opens: refresh interval, compact toggle, public-only toggle. Navigate with arrows, space flips toggles, type to edit refresh, Enter saves, Esc cancels. Changes apply live and persist back to your config file. The TUI is now its own settings UI; no need to drop to `$EDITOR ~/.config/octoscope/config.toml` mid-session.

  • `p` quick-toggle for public-only — the most "screenshot-relevant" switch deserves one key. Hit `p` from any tab and private repos / PRs / issues vanish instantly (or come back). A yellow `◐ public-only` badge sits next to `● authenticated` in the profile card so you always know which mode you're in. Useful when you want to demo octoscope to a colleague without flashing internal repo names.


There's also a notable architectural cleanup under the hood: the public-only filter moved from the fetch path to the render path. Toggling it doesn't cost a network round-trip anymore — the underlying GraphQL response always carries the full picture, and `Stats.Public()` produces a filtered copy on demand. That's why the toggle is instant.


Plus: the landing page (https://gfazioli.github.io/octoscope/) got a fixed glass nav with scroll-spy, a Mac-style title bar around the hero screenshot, and a dedicated Configuration section with a TOML snippet. Worth a look if you haven't visited recently.


Install / upgrade:

brew install gfazioli/tap/octoscope

or, if you already have it:

brew upgrade gfazioli/tap/octoscope

Run `octoscope`, press `,` for settings, `p` to toggle public-only.


Release notes: https://github.com/gfazioli/octoscope/releases/tag/v0.8.1

Landing: https://gfazioli.github.io/octoscope/

Feedback welcome on GitHub Issues — the in-app panel was a direct response to feedback in the v0.7.x thread that "users shouldn't have to edit a config file just to slow down the refresh".

24 views

Add a comment

Replies

Best
Alex J Jemmy

The move from config files to an in-app settings panel feels like a big usability win. Not everyone wants to jump into a TOML file just to tweak a small thing. Having live changes inside the TUI makes it feel more like a complete product instead of a dev tool.

Giovambattista Fazioli

@alex_j_jemmy Thanks Alex!

That’s exactly the thinking behind it — octoscope started as a pretty typical CLI tool where config meant editing a file, but the more I used it myself the more I realized that friction was unnecessary.
The in-app panel (just press ,) writes back to the same TOML file, so you get the best of both worlds: quick tweaks in the TUI, and a portable config you can version-control or copy across machines.

🙏 Appreciate the feedback!