0.5.1

Your GitHub — or anyone else's — at a glance

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.

octoscope dashboard showing profile, social, activity, operational and network sections with a coloured languages bar

At a glance

Profile

Who you are

Name, login, pronouns, bio, company, location, website, and how many years you've been on GitHub.

Social

Followers & stars

Followers, following, and total stars received across your non-fork repositories.

Activity

What you've shipped

Lifetime PRs authored and merged, issues opened, commits in the last year, plus a languages bar coloured with GitHub's own hex palette.

Operational

What's on your plate

Public repositories, forks received, open issues and open PRs across everything you own.

Network

Where you belong

Organisations you're a member of and verified social accounts — X, LinkedIn, Bluesky, Mastodon.

Any profile

Yours, or anyone else's

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.

Live feedback

See what moved

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.

Notifications

Stars & followers, live

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.

Auto-refresh

Stays current on its own

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.

Install

Homebrew (macOS & Linux)
$ brew install gfazioli/tap/octoscope
From source (Go 1.25+)
$ go install github.com/gfazioli/octoscope@latest
Pre-built binary

Grab a platform archive from the latest GitHub Release and drop the binary on your $PATH.

Authentication: octoscope reads $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.

Usage

Your own dashboard (requires a token)
$ octoscope
Any public profile (token optional)
$ octoscope torvalds
$ octoscope gvanrossum
$ octoscope gfazioli

While running: r refreshes on demand, q quits. Auto-refresh ticks every 60 seconds.

What octoscope can't show

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.