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.
Every repo in one sortable, searchable list — language, stars, forks, open issues, last push. Press s to sort, / to search.
Your open pull requests across every repo — draft, ready or conflicting, newest-update first. Same sort & search as Repos.
Every issue you've authored, wherever it lives. Sort by number or updated, filter by substring — whole backlog, no browser.
52 weeks of contributions as a heatmap — plus total, current streak, longest streak and busiest day from the same cells.
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 row of Repos / PRs / Issues for a rich detail view: descriptions in markdown, reviewers, checks, comments, linked PRs and timelines — one targeted GraphQL query per item, no rate-limit pressure.
A small ~/.config/octoscope/config.toml lets you set refresh_interval, toggle public_only and turn on the dense compact layout. CLI flags --refresh 30s, --compact and --public-only override the file when you want a one-off run. Press , for the in-app settings panel or p for a one-key public/private toggle — both apply live and persist back to the file.
Refined in v0.11.0. Press enter on any row of Repos / PRs / Issues to slide into a dedicated detail panel for that item — the canonical TUI gesture, mirroring lazygit / k9s / ranger. Each tab gets its own rich detail: Repos show visibility / license / language chips, description, quick stats, latest release, languages bar, recent commits with a N total · M by you in the last year inline counter, open issues / PRs preview, and topics; PRs add a state chip (Open / Draft / Merged / Closed), glamour-rendered description, reviewers, checks summary, files changed, recent commits, labels, and a curated timeline; Issues show a state chip, glamour-rendered description, assignees, recent comments, labels, linked PRs (those that would close the issue when merged), and a curated timeline. All in a single targeted GraphQL query per item, no fan-out across your list, no rate-limit pressure. Press space instead for the action menu (o open in browser, d view details, c copy URL) when you'd rather pick than commit.
The single-letter shortcuts also work directly from inside the action menu, so power users skip selection entirely. esc goes back to the list with the cursor preserved; r refetches; q quits the app from any depth, same as ctrl+c. Mutating actions (close issue, merge PR) are deliberately out of scope — octoscope stays read-only by design.
Seven built-in palettes, swappable on the fly with --theme NAME, the theme config key, or live in the in-app settings panel (, → Theme → ← / →). The dashboard repaints in the new colours without a restart.
The full set: octoscope (default, pink + cyan), high-contrast, terminal (adapts to your emulator), monochrome (zero chroma), stranger-things, phosphor (CRT green), amber (CRT amber). You can also override just the accent slot — accent_color = "#FF0080" in your config — while keeping the rest of the palette on the named theme.
octoscope reads ~/.config/octoscope/config.toml on startup (honours $XDG_CONFIG_HOME when set). All keys are optional; missing keys fall back to defaults. CLI flags override file values. The file is not created automatically — drop the snippet below in to get started.
# Auto-refresh interval. Go duration syntax: 30s, 1m, 5m, 1h.
refresh_interval = "1m"
# Hide private repositories, PRs and issues from the list tabs.
public_only = false
# Use the dense card layout in the Overview tab.
compact = false
# Visual theme. Built-in: octoscope (default), high-contrast,
# terminal, monochrome, stranger-things, phosphor, amber.
theme = "octoscope"
# Optional override for just the accent slot of the active theme.
# Hex ("#FF0080") or ANSI 256 ("201"). Leave unset to keep default.
# accent_color = "#FF0080"
You can also tweak everything from inside octoscope: press , (comma) while running and a settings panel opens. Changes apply live — a new refresh_interval reschedules the auto-refresh tick, compact re-renders immediately, public_only filters the lists on the spot, and theme repaints the whole dashboard in the new palette — and persist back to your config file.
$ brew install gfazioli/tap/octoscope$ go install github.com/gfazioli/octoscope@latest
Grab a platform archive from the latest GitHub Release and drop the binary on your $PATH.
$GITHUB_TOKEN first, then falls back to
gh auth token. A token is effectively required if you keep
the dashboard open for more than a few minutes — the unauthenticated GitHub rate limit
(60/hour) won't survive the 60-second auto-refresh loop.
read:user
(plus repo if you want private content) is enough;
fine-grained tokens just need read on Metadata, Contents, Issues, Pull requests,
Profile and Followers. Full breakdown in the
README.
$ octoscope$ octoscope torvalds
$ octoscope gvanrossum
$ octoscope gfazioli
While running: 1–5 or
tab switches tab,
r refreshes on demand,
q quits. Auto-refresh ticks every 60 seconds.
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.