Integrate ts_knowledge_graph with Claude Code (Graphify-style)
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 48/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Tranquilo
- Stack tecnológico
- typescript
- Área
- ai, developer-experience, tooling
Línea de trabajo
Empieza leyendo los métodos existentes de GraphQuery y los comandos de consulta de la CLI que admiten --json. Después, revisa la integración propuesta de .claude/skills/SKILL.md y determina cómo expondría el adaptador MCP previsto las mismas operaciones. Se considera terminado cuando la integración acordada con Claude Code esté documentada y se pueda usar sin cambios en la capa central de consultas del grafo.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Goal
Integrate ts_knowledge_graph with Claude Code (and other agents) the way Graphify is — let the agent query the knowledge graph instead of blindly grepping the codebase.
How Graphify does it
Graphify's Claude Code integration is a bundle of three standard Claude Code extension points:
- A
CLAUDE.mddirective — tells Claude to read the generated graph report before answering architecture/dependency questions. - A
PreToolUsehook insettings.json— fires before everyGrep/Globcall so the graph is consulted first (the "always-on" angle they advertise). - An MCP server exposing the graph as callable tools — the most agent-native path, still on Graphify's roadmap (their issue #146), not shipped.
Why we are well positioned
The query layer is already designed as "JSON in, JSON out" agent tools:
GraphQuerymethods (whoCalls,blastRadius,deadExports,neighborhood,references) map one-to-one onto agent tools.- Every CLI query command accepts
--json.
The hard part (a clean, machine-readable query surface) is done; integration is plumbing on top.
Options (lowest to highest effort)
| Approach | What it is | Effort | Best when |
|---|---|---|---|
| CLAUDE.md + slash commands | A directive telling Claude to run ts-knowledge-graph blast-radius <id> --json for impact questions, plus optional /blast-radius commands in .claude/commands/ |
Tiny | Just want Claude to know the tool exists and use it |
| A Skill | A .claude/skills/ skill documenting when/how to invoke the CLI via Bash |
Small | Want automatic triggering + self-documentation — closest to how Graphify ships |
| PreToolUse hook | Intercept Grep/Glob, inject graph context or remind Claude to query the graph first |
Small–medium | Want it consulted before search, not on demand |
| MCP server | Wrap GraphQuery as MCP tools (who_calls, blast_radius, dead_exports, …) so Claude calls them natively, no Bash |
Medium | The most native, portable path — works across Claude Code, Cursor, etc. |
Proposed plan
- Start with a Skill — matches Graphify's actual shipping form, fastest to value. Wraps the existing
--jsonCLI; zero changes to core code, just aSKILL.mdteaching Claude the commands and when to reach for blast-radius / dead-exports / who-calls. - Then add an MCP server — thin adapter over
GraphQuery(already JSON-in/JSON-out) for tool-native, cross-agent use. - Skip the
PreToolUsealways-on hook initially — clever but adds latency to every search and is the easiest piece to add later.
References
- Graphify GitHub: https://github.com/safishamsi/graphify
- Graphify + Claude Code integration page: https://graphify.net/graphify-claude-code-integration.html
- ck:graphify (ClaudeKit docs): https://docs.claudekit.cc/docs/engineer/skills/graphify
- Graphify + code-review-graph (DEV Community): https://dev.to/mir_mursalin_ankur/graphify-code-review-graph-build-a-self-updating-knowledge-graph-for-claude-code-and-other-ai-j1m
- Lenguaje dominante
- TypeScript
- Estrellas
- 7
- Forks
- 0
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de jeromeetienne/codespine
-
enhancement vision
Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100
jeromeetienne/codespine#234 · 1 comentario ·
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100
jeromeetienne/codespine#233 ·
-
Dificultad 4/5 3-5 días Aptitud para principiantes 45/100
jeromeetienne/codespine#232 ·
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100
jeromeetienne/codespine#223 ·
-
Dificultad 4/5 3-5 días Aptitud para principiantes 35/100
jeromeetienne/codespine#220 · 1 comentario ·
Todos los issues de jeromeetienne/codespine
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
ClickHouse/clickhouse-js#1130 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 85/100
Los mantenedores suelen responder en 1 día
-
bug claude Minor static-analysis
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
linagora/cozy-flagship-app#1359 ·
-
[Bug]: t3 connect status reports "Exposure: enabled" for publish-only links without a tunnelAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
Los mantenedores suelen responder en 1 día