Link Ticket To Session

Link en Claude Code-session til en Linear/Jira/GitHub-ticket eller PR i karma-dashboardet

Af JayantDevkar · JayantDevkar/claude-code-karma

Testet · Virker ★ 9.2/10

Link Ticket To Session — Link en Claude Code-session til en Linear/Jira/GitHub-ticket eller PR i karma-dashboardet

Hvad det gør

En slash-kommando, der linker den aktuelle Claude Code-session til en ticket (Linear, Jira, GitHub Issue eller GitHub PR) ved at POSTe til den lokale karma observability API, eventuelt caching af titel/status hentet via en installeret provider MCP. Udløses kun, når brugeren eksplicit beder om at linke, vedhæfte, associere eller forbinde sessionen til en ticket/issue/PR — ikke ved forbipasserende omtaler af ticket-nøgler. Kræver, at karma API-serveren kører (standard localhost:8020).

Testrapport

Klonede repoet, startede den rigtige karma FastAPI-server (uvicorn main:app --port 8020) i et isoleret HOME og kørte skill'ens faktiske curl-kommandoer. BASELINE (naiv: POST en GitHub PR med url .../issues/42) gemte PR'en fejlagtigt som et issue; SKILL-følgende (bevar /pull/-typen, jf. trin 4) gemte url .../pull/42 for den samme octocat/repo#42 — en konkret, observerbar forskel, som karma UI'en bruger til at gengive issue-vs-PR. Verificerede også live: Trin 5 PUT med URL-kodet nøgle (octocat%2Frepo%2342) satte title="Fix linting"/status="MERGED"; et bart "#42" blev afvist med HTTP 400 og den præcise antydning, SKILL.md beskriver; et bart LINEAR-123 med provider-hint producerede search-URL-fallback. Frontmatter parses (name+description), ingen hardcoded machine paths (bruger ${KARMA_API_URL} og ${CLAUDE_SESSION_ID}), ingen sikkerhedsbrister (read-only, loopback-only). Reel friktion værd at bemærke: den kræver, at karma-serveren kører, men jeg kørte den, og alle endpoints opførte sig præcis som dokumenteret.

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

Installation

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).

Kommandoer og eksempelprompter

  • /link-ticket-to-sessionLink en Claude Code-session til en Linear/Jira/GitHub-ticket eller PR i karma-dashboardet

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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