ResolveKit

A desktop app that gives developers organized workspaces for resolving GitHub issues using Claude. Import a project, pick an issue, and Claude launches with full context — the issue body, comment history, and a structured workflow — so you never repeat yourself.

Built with Tauri 2 (Rust + React + TypeScript). ~9MB binary.

Why

If you maintain open source projects or work through issue backlogs, you know the pain:

1. Open a GitHub issue
2. Copy context into Claude / ChatGPT
3. Go back and forth explaining what the project does
4. Lose the conversation when you switch issues
5. Start over next time

ResolveKit eliminates steps 2-5. Every issue gets a dedicated workspace with Claude pre-loaded with the full context. Conversations persist across sessions. The workflow is structured so Claude analyzes feasibility, asks for guidance, implements, reviews its own code, and drafts PRs and comments — all with your approval at each step.

Features

• Project import — Add repos by URL or local folder. Forks auto-detected; issues sync from upstream.
• Issue triage — Browse issues with keyboard shortcuts. Mark as Open, In Progress, Complete, or Not Viable.
• Focus mode — Split view: issue detail on the left, terminal panel on the right. Click an issue to jump straight in. Launch Claude or open a plain terminal when you're ready.
• Custom Claude prompts — Add your own system prompt globally or per-project. Prepended to the built-in workflow, or toggle override to replace it entirely.
• Structured workflow — Claude follows a defined flow: feasibility analysis, implementation, code review (security + cleanup), test plan, PR creation, GitHub commenting. You approve each step.
• Persistent terminals — Terminals survive navigation. Switch between issues without losing your Claude session. Output is buffered and replayed when you return.
• Session resume — Claude sessions are named per-issue. Come back later and the conversation picks up where you left off via --resume.
• Fork-aware — PRs go to your fork, issues and comments go to upstream. Claude knows the difference.
• Resolution tracking — Internal status per issue (separate from GitHub state). Completed and not-viable issues hide from the list but count in analytics.
• Analytics — Per-project and global stats: resolution breakdown, issue velocity, label distribution, time-to-close.
• Keyboard-driven — j/k navigate, c complete, x not viable, i in progress, o open, Enter to open an issue.
• Per-project preferences — Sort order and view mode persist per project.
• Voice support (macOS) — Microphone permission declared so voice input works with Claude in embedded terminals.

Quick Start

Prerequisites

• macOS (Apple Silicon or Intel)
• GitHub CLI installed and authenticated (gh auth login)
• Claude CLI installed (for Focus mode)

Install from DMG

Download the latest .dmg from Releases, open it, drag ResolveKit to Applications.

Build from source

git clone https://github.com/jippylong12/resolve-kit.git
cd resolve-kit
pnpm install
pnpm tauri build

The .app lands in src-tauri/target/release/bundle/macos/ResolveKit.app.

See docs/BUILD.md for full build, signing, and versioning details.

Development

pnpm tauri dev

How It Works

1. Add a project

Import by GitHub URL or select a local folder. ResolveKit reads the git remote, detects forks, and syncs all open issues via the GitHub GraphQL API.

2. Triage issues

Browse the issue list sorted oldest-first by default. Use keyboard shortcuts to mark resolution status. Completed and not-viable issues hide automatically.

3. Focus on an issue

Click an issue to enter Focus mode — a split view with the issue detail and a terminal panel. Click the Claude button to launch Claude with:

• The full issue body and comment history
• A 9-phase workflow prompt (branch setup, feasibility, guidance, implementation, code review, test plan, PR, comment, completion)
• Fork-aware gh commands (issues/comments to upstream, PRs from your fork)

Or open a plain terminal to work manually. Terminals persist when you navigate away.

4. Work through the phases

Claude follows the workflow:

1. Branch setup — checks out or creates issue-{number}
2. Feasibility — analyzes if the issue is resolvable, gives a YES/NO verdict
3. Decision — if not feasible, drafts a closing comment for your approval
4. Guidance — asks if you have specific constraints
5. Implementation — makes the code changes
6. Code review — automatically audits for security issues, removes debug code, checks readability
7. Test plan — tells you exactly how to verify the fix
8. PR creation — drafts title + description, creates PR on approval
9. Issue comment — drafts a summary comment, posts on approval

You control the pace. Claude waits for your input at each gate.

5. Track progress

Mark the issue as Complete or Not Viable. Check Analytics for resolution stats, velocity charts, and label distributions across projects.

Tech Stack

Layer	Technology
Shell	Tauri 2.x (Rust backend, WebView frontend)
Frontend	React 18 + TypeScript + Tailwind CSS 4 + Zustand
Database	SQLite via sqlx
Terminal	xterm.js + portable-pty (via tauri-plugin-pty)
GitHub	octocrab (GraphQL) + gh CLI
Charts	Recharts

Settings

Go to Settings in the sidebar:

General tab:

• Editor command — CLI command to open projects (e.g. code, cursor, zed). Used by the Editor button in Focus mode.
• Claude summaries — Toggle AI-powered session summaries.
• CLI status — Shows whether gh and claude are detected.

Claude tab:

• Custom system prompt — Extra instructions prepended to every Claude session.
• Override built-in prompt — Replace the built-in workflow entirely with your own prompt.

Per-project prompt settings are available via the gear icon on the issue list header.

Keyboard Shortcuts

Issue List

Key	Action
j / k	Navigate up/down
Enter	Open issue
c	Mark complete
x	Mark not viable
i	Mark in progress
o	Mark open

Issue Detail

Key	Action
c	Mark complete
x	Mark not viable
i	Mark in progress
o	Mark open

License

MIT