claude-issue-tracker

claude-issue-tracker

A Claude Code plugin that automatically tracks every session as a GitHub Issue in the repository you're currently working in.

What it does

Event	Action
Session starts	Creates a new GitHub Issue in your working repo: Claude Session — <project> [timestamp]
You submit a prompt	Appends a 🧑 Prompt comment to the issue
Claude responds	Appends a 🤖 Claude Response comment to the issue
Session ends	Closes the issue

Each session gets its own issue. Resume a session? The existing issue is reused — no duplicates.

Example

An issue in your repo will look like:

Claude Session — my-app [2026-04-12 14:32:00]

Session ID: `abc123...`
Started: 2026-04-12 14:32:00
Working Directory: /Users/me/projects/my-app
---
Every prompt and response in this session will be appended as comments below.

Followed by comments:

🧑 Prompt — 14:32:05
Add a dark mode toggle to the settings page

🤖 Claude Response — 14:32:12
I'll add a dark mode toggle...

Prerequisites

• gh CLI installed and authenticated:

  gh auth login --scopes "repo"
  

• Working directory must be a git repo with a GitHub remote (git remote get-url origin)
• Python 3

Installation

From GitHub

# 1. Add this repo as a plugin marketplace source
/plugin marketplace add afarntrog/claude-issue-tracker-plugin

# 2. Install the plugin from the marketplace
/plugin install claude-issue-tracker@claude-issue-tracker

Manual

Clone this repo and add to your .claude/settings.json:

{
  "plugins": ["/path/to/claude-issue-tracker-plugin"]
}

Usage

Just use Claude Code normally in any GitHub-backed repo. Sessions are tracked automatically.

Check current session

/claude-issue-tracker:session-status

How it works

The plugin uses four Claude Code hooks:

Hook	Trigger	Action
SessionStart	New session begins	Detects git remote, creates issue, saves state
UserPromptSubmit	You send a prompt	Appends prompt as a comment
Stop	Claude finishes a response	Reads transcript, appends response as a comment
SessionEnd	Session ends	Closes the issue

All hooks run asynchronously and never block Claude.

State & logs

Path	Purpose
~/.claude/plugins/claude-issue-tracker/state/	Per-session JSON state files
~/.claude/plugins/claude-issue-tracker/tracker.log	Hook execution log

Troubleshooting

Issue not being created?

• Check ~/.claude/plugins/claude-issue-tracker/tracker.log for errors
• Ensure gh auth status shows you're authenticated with repo scope
• Ensure the working directory has a GitHub remote: git remote get-url origin

No response comments appearing?

• The Stop hook reads the transcript file to extract Claude's response. Check that transcript_path is being provided in the hook input and the file is readable.

Seeing duplicate issues?

• Each session_id creates at most one issue. State is stored in ~/.claude/plugins/claude-issue-tracker/state/.

License

MIT