octopeek

Status: 0.1.0 — first public release. All core interactive features are implemented.

A fast, keyboard-driven TUI for your GitHub PR and issue inbox.

octopeek is a terminal application that gives you a unified, keyboard-navigable view of every pull request and issue that needs your attention across multiple repositories — whether you're the author, a requested reviewer, or an assignee. It stays out of your way when you're in flow and puts all the context you need at your fingertips when you're doing triage.

Screenshot

Asciicast demo coming shortly — run octopeek locally in the meantime.

Features

Phase 1 — Scaffold

• Keyboard-driven event loop with panic-safe terminal teardown
• 8 built-in color themes (Default, Dracula, Solarized Dark/Light, Nord, Gruvbox Dark/Light, GitHub Light)
• Multi-repository tab bar with overflow indicators
• XDG-compliant config and session persistence
• Auto-refresh timer infrastructure (configurable, default disabled)
• Full keybinding help overlay (?)
• Dual MIT/Apache-2.0 license, CI, issue templates

Phase 2 — GitHub data layer

• GitHub GraphQL client (GITHUB_TOKEN / gh auth login)
• PR/issue inbox: author, reviewer, assignee roles with A, R, @ glyphs

Phase 3 — Dashboard UI

• Scrollable PR/issue list with role-aware sorting and CI status column
• Per-repo toggle between PR and Issue view (i)

Phase 4 — Detail view & actions

• Full PR/issue detail rendered from markdown (pulldown-cmark + syntect)
• Open in browser (o), copy URL (y)

Phase 5 — Checkout & repo management

• Repo picker overlay (p): add/remove watched repos, persisted to config
• Branch checkout with confirmation overlay (c)

Phase 6 — Distribution (coming next)

• Pre-built release binaries via GitHub Actions
• Crates.io publication

Install

cargo install octopeek

Or install the latest main branch directly:

cargo install --git https://github.com/leboiko/octopeek

Quick Start

1. Authenticate with GitHub:

   gh auth login
   # or:
   export GITHUB_TOKEN=ghp_...
   

2. Create a config file at the platform-specific path:

   OS	Config path
   Linux	~/.config/octopeek/config.toml (or $XDG_CONFIG_HOME/octopeek/)
   macOS	~/Library/Application Support/octopeek/config.toml
   Windows	%APPDATA%\octopeek\config.toml

   Example (macOS):

   mkdir -p ~/Library/Application\ Support/octopeek
   cat > ~/Library/Application\ Support/octopeek/config.toml << 'EOF'
   theme = "default"
   repos = [
     "rust-lang/rust",
     "tokio-rs/tokio",
   ]
   # auto_refresh_seconds = 60  # uncomment to enable background refresh
   EOF
   

   Don't remember the path? Add repos interactively with the p keybinding — the picker writes to the correct location for you.

3. Launch:

   octopeek
   

Configuration

Location varies by platform (see Quick Start). On Linux:

~/.config/octopeek/config.toml:

# Color theme. Options:
#   default, dracula, solarized_dark, solarized_light,
#   nord, gruvbox_dark, gruvbox_light, github_light
theme = "default"

# Repositories to watch, in owner/name format.
repos = [
  "rust-lang/rust",
  "tokio-rs/tokio",
  "ratatui-org/ratatui",
]

# Background refresh interval in seconds.
# Remove or set to null to disable (manual refresh with r/R).
auto_refresh_seconds = 120

# Use plain ASCII box-drawing characters instead of Unicode.
# Useful for terminals with limited glyph support.
show_ascii_glyphs = false

Requirements

• gh CLI (recommended) or a GITHUB_TOKEN environment variable — required for GitHub API access.
• git on $PATH — required for the branch checkout feature (c).
• A terminal with 256-color support (most modern terminals qualify).

Quick demo

No GitHub token? Use the debug dump command to inspect raw data without launching the TUI:

# Print full inbox as JSON (useful for CI/scripts):
octopeek debug dump

# Print full PR detail:
octopeek debug dump pr rust-lang/rust 12345

# Print full issue detail:
octopeek debug dump issue rust-lang/rust 12345

Keybindings

Global

Dashboard

Detail view

Repo picker overlay (p)

Confirmation overlay (c)

Contributing

See CONTRIBUTING.md.

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project shall be dual-licensed as above, without any additional terms or conditions.