blippy

GitHub in your terminal.

blippy is a keyboard-first TUI for GitHub issues and pull requests.

https://github.com/user-attachments/assets/14daa99b-c39a-43d9-b32d-9d5a6840819f

See the full feature demo for more screenshots.

Requirements

• Rust toolchain (1.93+ recommended) for source builds
• GitHub CLI (gh) is heavily recommended for the best workflow (auth fallback, PR checkout, and smoother GitHub integration)
• OS keychain support (macOS Keychain, Windows Credential Manager, Linux Secret Service)

Install

npm (global)

npm i -g blippy

Homebrew

brew install AksharP5/tap/blippy

Shell installer (macOS/Linux)

curl -fsSL https://github.com/AksharP5/blippy/releases/latest/download/blippy-installer.sh | bash

PowerShell installer (Windows)

irm https://github.com/AksharP5/blippy/releases/latest/download/blippy-installer.ps1 | iex

Build from source

cargo install --git https://github.com/AksharP5/blippy

CLI Commands

• blippy: launch the TUI
• blippy --version: show version information
• blippy sync: scan local repos and cache GitHub remotes
• blippy auth reset: remove stored auth token from keychain
• blippy cache reset: remove local cache database

What You Can Do

• Browse and manage issues and pull requests
• Open linked issues/PRs in TUI or browser
• Review PR diffs with inline comments and thread resolution
• Merge pull requests from the TUI when repository permissions allow
• Edit labels and assignees (when repository permissions allow)
• Customize themes, keybindings, and close-comment presets

See FEATURES.md for a full feature breakdown.

Keyboard and Mouse

• blippy prioritizes keyboard workflows for reliability
• Mouse/trackpad support exists, but it can be finicky
• Full key reference: KEYBINDS.md

Configuration

• Config file: ~/.config/blippy/config.toml
• Keybind overrides: ~/.config/blippy/keybinds.toml
• Example keybind file: keybinds.example.toml

Theme example:

theme = "midnight"

Available built-in themes:

• github_dark (default)
• midnight
• graphite

Comment preset example:

[[comment_defaults]]
name = "close_default"
body = "Closing this issue as resolved."

Documentation

• Feature demo with screenshots: DEMO.md
• Authentication and PAT setup: AUTH.md
• Feature guide: FEATURES.md
• Key reference: KEYBINDS.md
• Contributing guide: CONTRIBUTING.md
• Release history: CHANGELOG.md