Link Ticket To Session

Vincula una sesión de Claude Code a un ticket o PR de Linear/Jira/GitHub en el panel de karma

Por JayantDevkar · JayantDevkar/claude-code-karma

Probado · Funciona ★ 9.2/10

Link Ticket To Session — Vincula una sesión de Claude Code a un ticket o PR de Linear/Jira/GitHub en el panel de karma

Qué hace

Un comando de barra que vincula la sesión actual de Claude Code a un ticket (Linear, Jira, GitHub Issue o GitHub PR) mediante una solicitud POST a la API de observabilidad local de karma, opcionalmente almacenando en caché el título/estado obtenido a través de un MCP de proveedor instalado. Se activa solo cuando el usuario pide explícitamente vincular, adjuntar, asociar o conectar la sesión a un ticket/issue/PR — no por menciones de claves de ticket. Requiere que el servidor API de karma esté en ejecución (por defecto localhost:8020).

Informe de la prueba

Se clonó el repositorio, se inició el servidor real de karma FastAPI (uvicorn main:app --port 8020) en un HOME aislado y se ejecutaron los comandos curl reales de la habilidad. La LÍNEA BASE (ingenua: POST un PR de GitHub con url .../issues/42) almacenó el PR mal etiquetado como un issue; la versión siguiendo la HABILIDAD (conservar el tipo /pull/, según el Paso 4) almacenó url .../pull/42 para el mismo octocat/repo#42 — una diferencia concreta y observable que la UI de karma utiliza para renderizar issue vs PR. También se verificó en vivo: el Paso 5 PUT con clave codificada en URL (octocat%2Frepo%2342) estableció title="Fix linting"/status="MERGED"; un "#42" simple fue rechazado con HTTP 400 y la pista exacta que describe SKILL.md; un LINEAR-123 simple con pista de proveedor produjo el fallback de URL de búsqueda. El frontmatter se analiza (name+description), sin rutas de máquina codificadas (usa ${KARMA_API_URL} y ${CLAUDE_SESSION_ID}), sin problemas de seguridad (solo lectura, solo loopback). Fricción real a tener en cuenta: necesita que el servidor de karma esté en ejecución, pero lo ejecuté y todos los endpoints se comportaron exactamente como se documentó.

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

Instalación

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

Comandos y prompts de ejemplo

  • /link-ticket-to-sessionVincula una sesión de Claude Code a un ticket o PR de Linear/Jira/GitHub en el panel de karma

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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