A native TUI that pulls profile, activity, repo health and network from the GitHub GraphQL API and keeps them current in the background. Works for your own account, or any public profile.
Drill into a repo with a red rollup dot and the Checks section names the failing jobs — failures first, so a red one can't hide in a twenty-job matrix — with each name a terminal hyperlink straight to its run.
Name, login, pronouns, bio, company, location, website, and how many years you've been on GitHub.
Followers, following, and total stars received across your non-fork repositories.
Lifetime PRs authored and merged, issues opened, commits in the last year, plus a languages bar coloured with GitHub's own hex palette.
Public repositories, forks received, open issues and open PRs across everything you own.
Organisations you're a member of and verified social accounts — X, LinkedIn, Bluesky, Mastodon.
Run with no arguments for your own dashboard (with a token), or pass any GitHub username to see their public stats — octoscope torvalds, octoscope dhh, whoever.
When a value changes between refreshes — a new star arrives, someone follows, a PR merges — the affected card's border flashes accent-pink for two seconds. No diffing numbers with your eyes.
Changes to your Stars and Followers trigger a native system notification and a short beep. You notice passive attention even when octoscope is in a background tab. macOS, Linux and Windows — no configuration needed.
The dashboard re-fetches every 60 seconds so the numbers you're looking at are never more than a minute old. Press r at any time for an on-demand refresh, q to quit.
The footer surfaces your GitHub API budget live — rate 4872/5000 · reset 23m — coloured muted, warn-yellow under 20%, error-red under 5%. If you hit the ceiling, auto-refresh backs off until the bucket refills instead of hammering every 60s.
Pass --public-only at launch — or hit p while running — to hide private repos, PRs and issues from the lists. Perfect for demos, screencasts and screenshots where you don't want internal work leaking. A yellow ◐ public-only badge sits next to authenticated in the profile card so you always know what mode you're in. Global counters stay complete; only the titles get filtered.
When a refresh fails, the footer tells you why: rate-limited · retry at 14:23, token rejected · check $GITHUB_TOKEN, offline · retrying, or github errored · retrying — so you know whether to wait, fix auth, or check the network.
Press enter on any Repos / PRs / Issues row for a rich detail view — markdown description, reviewers, checks, comments, timelines. Inside a PR, f opens the changed files and their syntax-highlighted diffs inline.
Since v0.13.0. A CI status dot on every row (green / red / yellow / dim) with a "by CI" sort that surfaces failures first. Press P to pin a repo to the top — persisted to your config.
Since v0.14.0. A 12-month star-history sparkline and a latest-release column in the Repos tab, plus watch_repos to monitor repositories you don't own in a dedicated section.
Since v0.15.0. A sticky "PRs awaiting your review" section when you're requested as a reviewer, plus richer macOS notification subtitles for star / follower changes.
Since v0.16.0. A launch sponsor splash (suppressed under --public-only) and a "What's new" tab (6) with the running version's highlights, bundled offline.
Since v0.17.0. Auto-refresh keeps exactly one timer, transient 5xx errors retry automatically, and Sponsors / release URLs are clickable OSC 8 hyperlinks. Pasting into the filter works; backspace is multibyte-safe.
Since v0.18.0. v toggles the star sparkline between density and a cumulative curve, % opens a rate-limit detail panel, and w cycles work filters (PRs open, CI broken, stale 90d).
Since v0.19.0. A quiet update notice with the right upgrade command for how you installed it (it never self-updates), and the dashboard now counts all your repos instead of just the first 100.
Since v0.20.0. On a repo's action menu, s runs a read-only supply-chain integrity scan for the Shai-Hulud / Miasma class of attack — scoring auto-execution surfaces, oversized / obfuscated payloads and forged or unsigned commit tips, not a single filename, so renamed variants still trip it. It explains every finding and hands you a fix script plus the right revoke links; it never touches the repo.
Since v0.21.0. Press P on an Issues row to pin it — pinned issues stick to the top of the tab in the order you pin them, compose with the sort cycle and / search, and are persisted to pinned_issues in your config. The same sticky-section treatment the Repos tab already had.
Since v0.22.0. Set NO_COLOR in your environment or pass --no-color and octoscope drops to its zero-chroma monochrome theme, overriding --theme and the config. It's per-run only — your saved theme and accent come back the moment NO_COLOR is unset.
Since v0.23.0. Auth failures now name the fix — an expired token points at the regenerate URL (or gh auth refresh), missing scopes are named — stale watch_repos entries surface a notice instead of vanishing, and default_sort / default_work_filter / default_star_history open octoscope the way you like it.
Since v0.24.0. Run octoscope --plain for a static text summary, or octoscope --json for a stable, versioned JSON contract you can pipe into jq, cron jobs or a shell status-line — no TUI. Both honour --public-only and the usual auth cascade.
A ~/.config/octoscope/config.toml sets refresh_interval, public_only, compact, theme and more. CLI flags override per-run; , opens the in-app settings panel, applied live and persisted.
The full guide is screenshot-forward and covers everything: getting started, a page per tab, the drill-ins and the integrity scan, themes, configuration and the settings panel, scripting with --plain / --json, and a keyboard cheat-sheet.
Your support helps me:
Open source thrives when those who benefit can give back — even a small monthly contribution makes a real difference. Sponsorships help cover maintenance time, infrastructure, and the countless invisible tasks that keep a project healthy.
Your help truly matters.
💚 Become a sponsor today and help me keep this project reliable, up-to-date, and growing for everyone.
Some things on your GitHub profile page aren't exposed by the GraphQL or REST APIs, so octoscope doesn't show them — achievements (Pull Shark, Starstruck, YOLO…), Highlights like the PRO badge, and the local time next to the location field. Surfacing any of these would require scraping the profile HTML, which we don't do.
