Prism is a powerful terminal-based dashboard designed to streamline interaction with GitHub. It provides an organized view of key elements such as open Pull Requests (PRs), inbox notifications, pending reviews, CI (Continuous Integration) status, and individual contributions—all presented in a user-friendly interface.

Features:

Prism displays five live tiles:

┌──────────────┬──────────────┬──────────────┐
│  MY OPEN PRS │  INBOX       │   PENDING    │
│              ├──────────────│   REVIEWS    │
│              │  CI STATUS   ├──────────────┤
│              │              │ CONTRIBUTIONS│
└──────────────┴──────────────┴──────────────┘

With these tiles, users can easily access and monitor crucial GitHub functionalities at a glance. The intuitive layout ensures a quick overview of ongoing developments within projects.

Quick Setup:

Setting up Prism is straightforward for users of the gh CLI. Once logged in, running prism will automatically retrieve authentication tokens for usage. For those not using gh, setting up the token manually is also effortless:

export GITHUB_TOKEN=ghp_yourtoken
prism

Alternatively, configuration can be stored in a config.toml file, allowing for customized settings such as refresh intervals and the number of items displayed.

Configuration Options:

The configuration is stored at ~/.prism/config.toml, where users can specify preferences like the refresh rate, maximum numbers for PRs, inbox items, and CI runs. An example configuration would look like this:

[auth]
token = ""  # or use GITHUB_TOKEN env var, or gh CLI auth

display
refresh_seconds = 30
max_prs = 20
max_inbox = 20
max_ci_runs = 15

[repos]
watched = []  # auto-discover from recent activity
# example:
# watched = ["myorg/backend", "myorg/frontend"]

Keybindings:

Prism supports a variety of key actions for navigating the dashboard efficiently:

Harness the capabilities of Prism to enhance productivity in managing GitHub workflows right from the terminal.