blippy 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.2](https://github.com/AksharP5/blippy/compare/v0.1.1...v0.1.2) - 2026-02-12
+
+### Added
+
+- *(keybinds)* switch default quit shortcut to Ctrl+C
+
+### Other
+
+- add links
+- *(ui)* drop status-copy/page shortcuts and simplify footer line
+
 ## [0.1.1](https://github.com/AksharP5/blippy/compare/v0.1.0...v0.1.1) - 2026-02-12
 
 ### Fixed

package/README.md

@@ -1,180 +1,100 @@
 # blippy
 
-Maintainer-first TUI for triaging GitHub Issues and PRs.
+GitHub in your terminal.
 
-## Requirements
-- Rust toolchain (Rust 1.93+ recommended)
-- GitHub CLI (optional, used for auth if available)
-- OS keychain available (macOS Keychain, Windows Credential Manager, Linux Secret Service)
+blippy is a keyboard-first TUI for GitHub issues and pull requests.
 
-## Quick Start
-```bash
-cargo run
-```
+## Requirements
 
-Press `q` to quit.
+- 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)
+
 ```bash
 npm i -g blippy
 ```
 
 ### Homebrew
+
 ```bash
 brew install AksharP5/tap/blippy
 ```
 
 ### Shell installer (macOS/Linux)
+
 ```bash
 curl --proto '=https' --tlsv1.2 -LsSf https://github.com/AksharP5/blippy/releases/latest/download/blippy-installer.sh | sh
 ```
 
 ### PowerShell installer (Windows)
+
 ```powershell
 irm https://github.com/AksharP5/blippy/releases/latest/download/blippy-installer.ps1 | iex
 ```
 
 ### Build from source
+
 ```bash
 cargo install --git https://github.com/AksharP5/blippy
 ```
 
-## Authentication (v0.1)
-On startup, auth is resolved in this order:
-1. `gh auth token --hostname github.com`
-2. OS keychain (`service=blippy`, `account=github.com`)
-3. Prompt for PAT (input hidden), then store in keychain
-
-Tokens are never written to config or db.
-
-## Personal Access Token (PAT)
-If prompted for a PAT, create one in GitHub settings:
-
-### Fine-grained token (recommended by GitHub)
-Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token
+## CLI Commands
 
-Suggested permissions:
-- Repository metadata: Read
-- Issues: Read/Write
-- Pull requests: Read/Write
+- `blippy`: launch the TUI
+- `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
 
-### Classic token (simpler)
-Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token
+## What You Can Do
 
-Suggested scopes:
-- `repo` (required for private repos and full Issues/PR access)
-- `read:org` (needed if you access org repositories)
+- Browse and manage issues and pull requests
+- Open linked issues/PRs in TUI or browser
+- Review PR diffs with inline comments and thread resolution
+- Edit labels and assignees (when repository permissions allow)
+- Customize themes, keybindings, and close-comment presets
 
-## Testing Auth
-```bash
-gh auth status
-gh auth token --hostname github.com
-```
-
-To see which auth source was used (development only):
-```bash
-BLIPPY_AUTH_DEBUG=1 cargo run
-```
+See [FEATURES.md](FEATURES.md) for a full feature breakdown.
 
-To force the PAT prompt:
-- Temporarily log out of GitHub CLI: `gh auth logout`
-- Remove the keychain entry for `blippy` / `github.com` using your OS keychain UI
+## Keyboard and Mouse
 
-To reset stored auth from the CLI:
-```bash
-blippy auth reset
-```
+- blippy prioritizes keyboard workflows for reliability
+- Mouse/trackpad support exists, but it can be finicky
+- Full key reference: [KEYBINDS.md](KEYBINDS.md)
 
-## Tests
-```bash
-cargo test
-```
+## Configuration
 
-## Cache
-- Cache lives in your OS user data directory as `blippy.db`
-- Reset cache: `blippy cache reset`
-
-## Sync
-- Run `blippy sync` to scan local repos and cache GitHub remotes
-- Issues are fetched when you open a repo in the TUI
-
-## Navigation
-- Ctrl+G: open repo picker
-- Ctrl+R: rescan repos
-- / in repo picker: search repos (owner/repo/path/remote)
-- Ctrl+h/j/k/l: switch focus between panes (issues list/preview, issue description/recent comments)
-- j/k: move or scroll focused pane
-- Ctrl+u / Ctrl+d: page up/down in focused pane
-- gg/G: jump top/bottom in focused pane
-- p: toggle issues / pull requests list mode
-- f: cycle issue filter (open/closed)
-- 1/2: switch issue tab (open/closed)
-- a: cycle assignee filter (all/unassigned/users)
-- /: search issues by number/title/body/labels/assignees (Enter keep, Esc clear)
-- m: add comment to selected issue
-- l: edit issue labels (comma-separated)
-- Shift+A: edit issue assignees
-- u: reopen selected closed issue/pull request
-- Enter: open selected issue
-- r: refresh issues/comments
-- o: open in browser
-- Shift+P: open linked pull request for selected issue in TUI
-- Shift+O: open linked pull request for selected issue in browser
-- v: checkout selected pull request locally (`gh pr checkout`)
-- dd: close selected issue/pull request with preset
-- c: open full comments from detail view
-- j/k: jump next/previous comment in full comments view
-- e: edit selected comment in full comments view
-- x: delete selected comment in full comments view
-- PR detail: right pane shows changed files + patch snippets (no checkout required)
-- Enter on PR changes pane: open full-screen PR changes viewer
-- PR review view: Ctrl+h/l switch files/diff, j/k navigate, w mark/unmark file viewed on GitHub, m add inline GitHub review comment
-- PR review view: h/l choose old/new side, z collapse/expand current hunk, Shift+V visual multiline range, e edit, x delete, Shift+R resolve/reopen thread on GitHub, n/p cycle comments on selected line
-- PR review view: `[`/`]` pan horizontally for long lines, `0` resets horizontal pan
-- Ctrl+y: copy current status message to clipboard
-- b or Esc: back from issue detail/comments
-- Mouse/trackpad: wheel scrolls lists/diffs, horizontal wheel pans PR diff, click rows to select/open, click global `[Repos]`, click `[Back]`, `[Files]`, `[Diff]`, Open/Closed tabs, and picker `[Apply]/[Cancel]`
-- comment editor: `Enter` submit, `Shift+Enter` newline (`Ctrl+j` fallback)
-
-Search supports simple GitHub-like qualifiers:
-- `is:open` or `is:closed`
-- `label:bug`
-- `assignee:alex`
-- `assignee:none` for unassigned
-- `#123` for exact issue number
-
-## Comment Defaults
-Configure close/comment presets in `config.toml`:
-```toml
-[[comment_defaults]]
-name = "close_default"
-body = "Closing this issue as resolved."
-```
+- Config file: `~/.config/blippy/config.toml`
+- Keybind overrides: `~/.config/blippy/keybinds.toml`
+- Example keybind file: [keybinds.example.toml](keybinds.example.toml)
 
-## Themes
-blippy supports built-in UI themes via `~/.config/blippy/config.toml`:
+Theme example:
 
 ```toml
 theme = "midnight"
 ```
 
 Available built-in themes:
+
 - `github_dark` (default)
 - `midnight`
 - `graphite`
 
-## Keybind Configuration
-- Every keyboard shortcut can be overridden.
-- Copy `keybinds.example.toml` to `~/.config/blippy/keybinds.toml` and edit values.
-- You can also place the same `[keybinds]` table inside `~/.config/blippy/config.toml`.
+Comment preset example:
 
-Example:
 ```toml
-[keybinds]
-quit = "ctrl+q"
-refresh = "ctrl+s"
-diff_scroll_left = "alt+h"
-diff_scroll_right = "alt+l"
+[[comment_defaults]]
+name = "close_default"
+body = "Closing this issue as resolved."
 ```
+
+## Documentation
+
+- Authentication and PAT setup: [AUTH.md](AUTH.md)
+- Feature guide: [FEATURES.md](FEATURES.md)
+- Key reference: [KEYBINDS.md](KEYBINDS.md)
+- Contributing guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Release history: [CHANGELOG.md](CHANGELOG.md)

package/npm-shrinkwrap.json

@@ -22,7 +22,7 @@
       },
       "hasInstallScript": true,
       "name": "blippy",
-      "version": "0.1.1"
+      "version": "0.1.2"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -514,5 +514,5 @@
     }
   },
   "requires": true,
-  "version": "0.1.1"
+  "version": "0.1.2"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/AksharP5/blippy/releases/download/v0.1.1",
+  "artifactDownloadUrl": "https://github.com/AksharP5/blippy/releases/download/v0.1.2",
   "bin": {
     "blippy": "run-blippy.js"
   },
@@ -10,7 +10,7 @@
     "detect-libc": "^2.1.2",
     "rimraf": "^6.1.2"
   },
-  "description": "Maintainer-first TUI for triaging GitHub issues and pull requests",
+  "description": "GitHub in your terminal",
   "devDependencies": {
     "prettier": "^3.7.4"
   },
@@ -75,7 +75,7 @@
       "zipExt": ".tar.gz"
     }
   },
-  "version": "0.1.1",
+  "version": "0.1.2",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"