Link Ticket To Session

Koppel een Claude Code sessie aan een Linear/Jira/GitHub ticket of PR in het karma dashboard

Door JayantDevkar · JayantDevkar/claude-code-karma

Getest · Werkt ★ 9.2/10

Link Ticket To Session — Koppel een Claude Code sessie aan een Linear/Jira/GitHub ticket of PR in het karma dashboard

Wat het doet

Een slash command dat de huidige Claude Code sessie koppelt aan een ticket (Linear, Jira, GitHub Issue, of GitHub PR) door te POSTen naar de lokale karma observability API, optioneel caching van title/status opgehaald via een geïnstalleerde provider MCP. Activeert alleen wanneer de gebruiker expliciet vraagt om de sessie te linken, attach, associëren of verbinden met een ticket/issue/PR — niet bij het passeren van ticket-key vermeldingen. Vereist dat de karma API server draait (standaard localhost:8020).

Testrapport

De repo gekloond, de echte karma FastAPI server (uvicorn main:app --port 8020) opgestart in een geïsoleerde HOME, en de daadwerkelijke curl commands van de skill uitgevoerd. BASELINE (naïef: POST een GitHub PR met url .../issues/42) sloeg de PR op als een issue; SKILL-followed (behoud de /pull/ soort, volgens Step 4) sloeg url .../pull/42 op voor dezelfde octocat/repo#42 — een concreet, waarneembaar verschil dat de karma UI gebruikt om issue-vs-PR weer te geven. Ook live geverifieerd: Step 5 PUT met URL-encoded key (octocat%2Frepo%2342) stelde title="Fix linting"/status="MERGED" in; een kale "#42" werd geweigerd met HTTP 400 en de exacte hint die SKILL.md beschrijft; een kale LINEAR-123 met provider hint produceerde de search-URL fallback. Frontmatter parseert (name+description), geen hardcoded machine paths (gebruikt ${KARMA_API_URL} en ${CLAUDE_SESSION_ID}), geen security smells (read-only, loopback-only). Echte frictie die het vermelden waard is: het heeft de karma server nodig om te draaien, maar ik heb het uitgevoerd en alle endpoints gedroegen zich precies zoals gedocumenteerd.

Getest op: 2026-07-31 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/JayantDevkar/claude-code-karma.git /tmp/link-ticket-to-session-src
mkdir -p ~/.claude/skills
cp -R /tmp/link-ticket-to-session-src/skills/link-ticket-to-session ~/.claude/skills/link-ticket-to-session
# PREREQUISITE: the karma API server must be running for the POST/PUT to succeed.
#   cd /tmp/link-ticket-to-session-src/api && pip install -r requirements.txt
#   uvicorn main:app --port 8020
# Override host/port with env KARMA_API_URL (default http://localhost:8020).
# OPTIONAL: install the provider MCP (Linear / Atlassian / github plugin) to cache title+status;
#   without it the link is still created with NULL metadata (refreshable later).

Commando's en voorbeeldprompts

  • /link-ticket-to-sessionKoppel een Claude Code sessie aan een Linear/Jira/GitHub ticket of PR in het karma dashboard

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Link this session to LINEAR-42
  • Attach this session to PR octocat/repo#7
  • Associate this work with issue #15