Link Ticket To Session

Collega una sessione Claude Code a un ticket Linear/Jira/GitHub o PR nella dashboard karma

di JayantDevkar · JayantDevkar/claude-code-karma

Promosso ★ 9.2/10

Link Ticket To Session — Collega una sessione Claude Code a un ticket Linear/Jira/GitHub o PR nella dashboard karma

Cosa fa

Un comando slash che collega la sessione Claude Code corrente a un ticket (Linear, Jira, GitHub Issue o GitHub PR) tramite POST all'API di osservabilità karma locale, memorizzando opzionalmente titolo/stato recuperati tramite un MCP provider installato. Si attiva solo quando l'utente chiede esplicitamente di collegare, allegare, associare o connettere la sessione a un ticket/issue/PR — non su menzioni di ticket-key passanti. Richiede il server API karma in esecuzione (predefinito localhost:8020).

Rapporto di test

Clonato il repo, avviato il vero server karma FastAPI (uvicorn main:app --port 8020) in una HOME isolata e eseguiti i comandi curl effettivi della skill. La BASELINE (ingenua: POST di una GitHub PR con url .../issues/42) ha memorizzato la PR etichettata erroneamente come issue; la SKILL-followed (preservare il tipo /pull/, secondo il Passaggio 4) ha memorizzato url .../pull/42 per lo stesso octocat/repo#42 — una differenza concreta e osservabile che l'interfaccia utente di karma utilizza per renderizzare issue-vs-PR. Verificato anche dal vivo: il Passaggio 5 PUT con chiave URL-encoded (octocat%2Frepo%2342) ha impostato title="Fix linting"/status="MERGED"; un semplice "#42" è stato rifiutato con HTTP 400 e l'esatto suggerimento descritto da SKILL.md; un semplice LINEAR-123 con suggerimento del provider ha prodotto il fallback dell'URL di ricerca. Il frontmatter viene parsato (name+description), nessun percorso macchina hardcoded (usa ${KARMA_API_URL} e ${CLAUDE_SESSION_ID}), nessun problema di sicurezza (sola lettura, solo loopback). Attrito reale degno di nota: richiede il server karma in esecuzione, ma l'ho eseguito e tutti gli endpoint si sono comportati esattamente come documentato.

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

Installazione

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

Comandi e prompt di esempio

  • /link-ticket-to-sessionCollega una sessione Claude Code a un ticket Linear/Jira/GitHub o PR nella dashboard karma

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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