Guide

Getting started

octoscope is a terminal dashboard for your GitHub account — profile, repositories, PRs, issues and CI status, auto-refreshing, without ever leaving your shell.

Install

The recommended path is Homebrew, on macOS and Linux:

$ brew install gfazioli/tap/octoscope

Or build from source with a Go 1.25+ toolchain — go install github.com/gfazioli/octoscope@latest.

Run it

With no arguments octoscope opens on your own authenticated account. Pass a username to inspect anyone's public profile:

$ octoscope                 # your account
$ octoscope torvalds        # anyone's public profile
$ octoscope --public-only   # hide private repos / PRs / issues
octoscope — Overview
octoscope Overview tab: profile card, social and activity stats, languages bar, top repositories
The Overview tab on launch — profile, social and activity counters, languages, top repositories and your network, all in one paint.

Six tabs, one keystroke away

Everything lives behind the number keys — no menus to hunt through:

  • 1 Overview — the dashboard above.
  • 2 Repos — every repository with its CI health, stars and last release.
  • 3 PRs and 4 Issues — what you've opened, plus review requests.
  • 5 Activity — a 12-month contribution heatmap.
  • 6 What's new — the running version's highlights, bundled offline.
?

Press ? at any time for the full in-app keymap, and r to refresh on demand. octoscope also auto-refreshes on an interval you control.

✓

octoscope is strictly read-only — it never creates, edits or closes anything on GitHub. A few things it simply can't show, because the API doesn't expose them: profile Achievements, the PRO badge, and your local timezone.