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.

Since v0.31.0 there are two more ways in. From inside the GitHub CLI:

$ gh extension install gfazioli/gh-octoscope
$ gh octoscope

The same binary from the same release. It sits under a second repository name only because gh takes an extension's name from the repository and refuses anything not prefixed gh- — everything else, issues included, stays in the main repository.

And a container, which is for the scriptable output rather than the dashboard — a TUI inside a container has nothing attached to read it:

$ docker run --rm -e GITHUB_TOKEN ghcr.io/gfazioli/octoscope:latest --plain

Multi-architecture, around 7 MB, and it runs as an unprivileged user. Every release also carries the bare executables beside the archives — octoscope_<version>_<os>-<arch> — for a curl where unpacking is the awkward part.

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

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, and a feed of what you actually did.
• 6 Gists — your gists, with the code in them.
• 7 Inbox — your GitHub notifications, read-only.
• 8 What's new — the running version's highlights, bundled offline.