Git Issue Flow

Fast, keyboard-driven GitHub issue management tool for efficient backlog grooming. No database, no servers - just your browser and GitHub API.

Made by James Pember

Screenshots

Easily fetch issues from Github using search syntax

Quicky move through issues, add labels, edit and save updates using keyboard shortuts

Enter an OpenAI API key to format or rewrite issues with AI

Keep tabs on your backlogs health, and make sure you're grooming issues faster than they're coming in

Quick Start

git clone https://github.com/jamespember/git-issue-flow.git
cd git-issue-flow
npm install
npm run dev

1. Open http://localhost:5173
2. Go to Settings tab
3. Add GitHub repository (owner/repo) and Personal Access Token
4. Configure priority labels to match your workflow
5. Press ⌘K/Ctrl+K to search and start grooming

Features

Core Workflow

• Command palette search with full GitHub query syntax
• Keyboard shortcuts for every action (Ctrl+H/M/L for priorities, Ctrl+E to edit, etc.)
• Inline markdown editing with live preview
• Real-time label management and GitHub sync

AI Integration (Optional)

• Format messy issues with AI
• Slack thread previews with summaries (Ctrl+Shift+S when links detected)
• Append Slack context directly to issues

Zero Config

• Works with any GitHub repository
• All settings stored in browser localStorage
• Test buttons for API tokens
• Import/export configurations

Setup

Required: GitHub Token

1. Go to GitHub Settings > Personal Access Tokens
2. Click "Generate new token" → "Generate new token (classic)"
3. Required scopes:
   • repo (Full control of private repositories) - Required for all repositories
   • read:org (Read org membership) - Only if using organization repositories
4. Copy the token (starts with ghp_)
5. Add to Settings in the app

Optional: Slack Integration

1. Go to Slack API Apps → "Create New App"
2. Required Bot Token Scopes:
   • channels:history (View messages in public channels)
   • channels:read (View basic info about public channels)
   • users:read (View people in workspace)
3. Install app to workspace and invite bot to relevant channels
4. Copy Bot User OAuth Token (starts with xoxb-)
5. Run proxy: node slack-proxy.cjs
6. Add bot token in Settings

Optional: OpenAI

Add API key in Settings for AI-powered features

Keyboard Shortcuts

Shortcut	Action
⌘K/Ctrl+K	Open search
Alt + ←	Previous issue
Alt + →	Next issue
Ctrl + E	Edit description
Ctrl + S	Save changes
Ctrl + C	Mark as complete
Ctrl + O	Open on GitHub
Ctrl + H	Set high priority
Ctrl + M	Set medium priority
Ctrl + L	Set low priority
Ctrl + X	Close as not planned
Ctrl + Shift + R	Refresh all issues
Ctrl + Shift + S	Preview Slack thread

Troubleshooting

GitHub auth failed: Check token validity and repo permissions
No issues found: Try simpler search like is:open is:issue
Slack not working: Ensure proxy is running and bot has channel access

License

MIT - see LICENSE file