Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
99 commits
Select commit Hold shift + click to select a range
785c9f4
fix: detect correct Python interpreter for pipx installs in git hooks
Minidoracat Apr 8, 2026
8a0dd45
fix: suppress graspologic ANSI output that corrupts PowerShell scroll…
azizur100389 Apr 8, 2026
312ba0d
docs: add graph.json + LLM workflow example to README
gdesai23 Apr 8, 2026
74e192d
docs: add Japanese README
eltociear Apr 8, 2026
f4c3c55
feat: add Trae and Trae CN platform support
ljinshuan Apr 8, 2026
b64c231
fix: skill-droid.md missing from package-data, louvain kwargs version…
safishamsi Apr 8, 2026
1cc54b3
fix: XSS in legend innerHTML and shebang allowlist in hooks
safishamsi Apr 8, 2026
6a3b4bb
fix: shebang allowlist validation in all skill files
safishamsi Apr 8, 2026
0dc125d
release: 0.3.15 — Trae platform, security hardening, pipx hooks, Powe…
safishamsi Apr 8, 2026
30a66ec
fix: switch star history chart to starchart.cc (no auth required)
safishamsi Apr 8, 2026
23d88c5
v0.3.16: NetworkX <3.4 compat, .jsx support, pipx follow-up fix
safishamsi Apr 8, 2026
dd8235e
v0.3.17: Julia support, smarter chunking, tree-sitter pin, progress o…
safishamsi Apr 8, 2026
8dbf953
docs: add .jsx .tsx .jl to extensions table, bump to 20 languages
safishamsi Apr 8, 2026
1a50f2d
add Penpax link to README
safishamsi Apr 9, 2026
ec4f684
add Korean README and fix trae.com link across all READMEs
safishamsi Apr 9, 2026
11dff7e
release 0.3.18: fix watch .graphifyignore, codex hook, trae link, Kor…
safishamsi Apr 9, 2026
29c639d
Apply PRs #82 #93 #102 #109: extension drift, click detection, skill …
safishamsi Apr 9, 2026
4d8cffe
Update CHANGELOG for v0.3.18 with PR fixes (#82 #93 #102 #109)
safishamsi Apr 9, 2026
f140d47
Fix install step: try plain pip before --break-system-packages (#126)
safishamsi Apr 9, 2026
096a76f
Release v0.3.19
safishamsi Apr 9, 2026
3501605
Add OpenCode tool.execute.before plugin via graphify opencode install…
safishamsi Apr 9, 2026
e1864d7
Update README for OpenCode tool.execute.before plugin
safishamsi Apr 9, 2026
38255e7
Fix XSS in HTML viz: escape node labels, types, source files, and edg…
safishamsi Apr 9, 2026
b7fd5ac
Fix AST call edges confidence: INFERRED/0.8 -> EXTRACTED/1.0 (#127)
safishamsi Apr 9, 2026
b101a99
Pin tree-sitter>=0.23.0, add version guard, confidence=EXTRACTED for …
safishamsi Apr 9, 2026
6f9fc65
Fix Codex hook JSON schema (#138) and use #!/bin/sh for Windows git h…
safishamsi Apr 9, 2026
a104a0d
Add monthly PyPI downloads badge to README
safishamsi Apr 9, 2026
f770712
Add Cursor support, fix _rebuild_code KeyError and node_link_data cra…
safishamsi Apr 9, 2026
0b8067c
Add Cursor to description, README intro, and PyPI keywords
safishamsi Apr 9, 2026
dcc402e
Add Gemini CLI support and sponsor nudge at pipeline completion (#105)
safishamsi Apr 9, 2026
687fbc8
Update README: add Cursor and Gemini CLI to all platform sections
safishamsi Apr 9, 2026
54c6d04
Switch star history to star-history.com for faster updates
safishamsi Apr 9, 2026
ee43236
Fix codex/opencode install idempotency — always run hook step (#153)
safishamsi Apr 9, 2026
e440539
Add Trendshift badge to README
safishamsi Apr 9, 2026
cf39034
Remove Trendshift badge (API not available)
safishamsi Apr 9, 2026
1cbcee5
release 0.3.25: Aider + Copilot CLI, directed graphs, frontmatter cac…
safishamsi Apr 9, 2026
863100c
fix MCP server path validation security issue (0.3.26)
safishamsi Apr 10, 2026
a0a196e
update README to list all platforms including Aider, Copilot CLI, Cur…
safishamsi Apr 10, 2026
55964bc
fix gemini install missing skill file copy (0.3.27)
safishamsi Apr 10, 2026
af3a3d2
update README Gemini CLI description to mention skill file copy
safishamsi Apr 10, 2026
f7ee752
switch downloads badge to pepy.tech to avoid shields.io rate limit
safishamsi Apr 10, 2026
210243f
fix hook reinstall, CRLF labels, skill-windows missing commands (0.3.28)
safishamsi Apr 10, 2026
79acb7e
Add video/audio corpus support with yt-dlp download and Whisper trans…
safishamsi Apr 10, 2026
f758911
Update README and descriptions to mention video/audio and YouTube sup…
safishamsi Apr 10, 2026
a2872ca
Add YouTube URL example to README usage, update repo about with pip i…
safishamsi Apr 10, 2026
2c21bc0
Fix CI: mock lazy anthropic import via sys.modules instead of module …
safishamsi Apr 10, 2026
699e996
Remove Anthropic API call from transcribe.py - agent generates Whispe…
safishamsi Apr 10, 2026
68bb2bd
Bump to 0.4.0, set v4 as working branch, update CI badge and skill URL
safishamsi Apr 10, 2026
3ce9bda
Add v4 to CI branch triggers
safishamsi Apr 10, 2026
fa388c8
Security: fix YAML injection in ingest.py, </script> injection in exp…
safishamsi Apr 10, 2026
209224d
Add dedicated video and audio corpus section to README
safishamsi Apr 10, 2026
0e45308
Remove YouTube URL references from README, use generic <video-url> pl…
safishamsi Apr 10, 2026
271ee0a
Fix #188: collect_files() now respects .graphifyignore; fix #195: ski…
safishamsi Apr 10, 2026
625ca0e
Bump to 0.4.1
safishamsi Apr 10, 2026
3c50340
fix bugs #211, #216, #217, #222 and bump to 0.4.2
safishamsi Apr 11, 2026
62aac4f
cherry-pick PRs #212, #220, #204, #221 into 0.4.2
safishamsi Apr 11, 2026
b4d4ac8
add 0.4.2 CHANGELOG entry
safishamsi Apr 11, 2026
013313f
add LinkedIn badge to README
safishamsi Apr 11, 2026
4205ae8
fix bugs #256, #253, #244, #226, #254 and bump to 0.4.3
safishamsi Apr 12, 2026
efce74d
update README: 22 languages, add .vue and .svelte to file types table
safishamsi Apr 12, 2026
0a4e691
fix #261, #249, #266 and bump to 0.4.4
safishamsi Apr 12, 2026
2499a1c
fix MCP ValidationError on blank stdin lines and bump to 0.4.5
safishamsi Apr 12, 2026
6b2d383
Add Google Antigravity platform support (0.4.6)
safishamsi Apr 12, 2026
c713cf8
Fix watch edge key, claw path, Blade support, WSL MCP docs (0.4.7)
safishamsi Apr 12, 2026
04e2960
Remove Claude-specific language from platform skill files (0.4.8)
safishamsi Apr 12, 2026
7c81c1b
release: v0.4.9 — PHP extractor improvements, Dart, diacritics, Herme…
safishamsi Apr 13, 2026
962f28c
docs: add Hermes platform, Dart to language list, 22→23 languages
safishamsi Apr 13, 2026
e441454
v0.4.11: fix query crash on MultiGraph, NoneType in serve.py, MCP CWD…
safishamsi Apr 13, 2026
9fd6810
Fix README: Codex does have PreToolUse hook support (#299)
safishamsi Apr 13, 2026
c657eb2
v0.4.12: add Kiro IDE/CLI support, fix cache portability across machines
safishamsi Apr 13, 2026
41544c7
Update pyproject.toml description and keywords to include all platforms
safishamsi Apr 13, 2026
79a9200
v0.4.13: Verilog support, HiDPI hyperedge fix, null label guards, AGE…
safishamsi Apr 14, 2026
9c04b05
docs: add Verilog/SystemVerilog to language count and list
safishamsi Apr 14, 2026
5c77d9c
Fix 9 issues: kiro package data, betweenness perf, wiki step, opencod…
safishamsi Apr 14, 2026
2736e05
Bump to 0.4.14, README: cross-file call-graph note
safishamsi Apr 14, 2026
9866cbc
Update CHANGELOG for 0.4.14, fix AGENTS.md rebuild command
safishamsi Apr 14, 2026
7ab62fd
v0.4.15: VS Code Copilot Chat, OpenCode/Gemini Windows fixes, .mjs/.e…
safishamsi Apr 15, 2026
2246e46
v0.4.16: fix watch NameError, .mjs dispatch, exclude llm.py from wheel
safishamsi Apr 16, 2026
fc34018
docs: v5 design spec -- rustworkx backend + GitHub repo ingestion
safishamsi Apr 16, 2026
1c0fd85
docs: revise v5 spec after senior engineering review -- GraphBundle, …
safishamsi Apr 16, 2026
69001d0
docs: v5.0 and v5.1 design specs -- enterprise foundation
safishamsi Apr 16, 2026
2c5d3a5
v0.4.19: fix #390 #298 #410 #401 #385, team workflow docs, Windows/pi…
safishamsi Apr 17, 2026
76d1203
changelog and readme for v0.4.19
safishamsi Apr 17, 2026
7490d9e
remove superpowers specs from repo (should be local only)
safishamsi Apr 17, 2026
69a0cfc
v0.4.20: fix #414 JS imports_from path normalisation, fix #418 graph.…
safishamsi Apr 17, 2026
36fa62a
bump to 0.4.20, changelog
safishamsi Apr 17, 2026
59f8dab
readme: clarify graph.html opens in any browser
safishamsi Apr 17, 2026
35fa45d
v0.4.21: fix #422 cluster-only KeyError total_files, fix #423 --updat…
safishamsi Apr 17, 2026
7662f04
bump to 0.4.21, changelog
safishamsi Apr 17, 2026
5011857
v0.4.22: fix #429 AST cache root, fix #428 add .mdx to DOC_EXTENSIONS
safishamsi Apr 18, 2026
2e82e49
readme: add .mdx to docs extensions table
safishamsi Apr 18, 2026
baa4474
readme: add pipx as alternative install method
safishamsi Apr 18, 2026
42599a7
v0.4.23: fix #178 stale version stamp, fix #260 add .html to DOC_EXTE…
safishamsi Apr 18, 2026
8d908c5
fix #432 to_html crash on large graphs, fix #431 Go import node ID co…
safishamsi Apr 18, 2026
04790e2
readme: swap pepy badge for shields.io downloads
safishamsi Apr 18, 2026
dc1158b
readme: show 200k+ total downloads badge
safishamsi Apr 18, 2026
7a0a5ac
readme: revert to pepy.tech total downloads badge
safishamsi Apr 18, 2026
a5d811f
Add Mermaid export for graph visualization
Apr 23, 2026
12677e7
Add CLI command for Mermaid export
Apr 23, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@ name: CI

on:
push:
branches: ["v1", "v2", "v3", "main"]
branches: ["v1", "v2", "v3", "v4", "main"]
pull_request:
branches: ["v1", "v2", "v3", "main"]
branches: ["v1", "v2", "v3", "v4", "main"]

jobs:
test:
Expand Down
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,6 @@ graphify-out/
.claude/
skills/
docs/superpowers/
.vscode/
openspec/
uv.lock
8 changes: 8 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
## graphify

This project has a graphify knowledge graph at graphify-out/.

Rules:
- Before answering architecture or codebase questions, read graphify-out/GRAPH_REPORT.md for god nodes and community structure
- If graphify-out/wiki/index.md exists, navigate it instead of reading raw files
- After modifying code files in this session, run `graphify update .` to keep the graph current (AST-only, no API cost)
265 changes: 265 additions & 0 deletions CHANGELOG.md

Large diffs are not rendered by default.

238 changes: 238 additions & 0 deletions README.ja-JP.md

Large diffs are not rendered by default.

282 changes: 282 additions & 0 deletions README.ko-KR.md

Large diffs are not rendered by default.

223 changes: 203 additions & 20 deletions README.md

Large diffs are not rendered by default.

21 changes: 16 additions & 5 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# graphify

[English](README.md) | [简体中文](README.zh-CN.md)
[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md) | [한국어](README.ko-KR.md)

[![CI](https://github.com/safishamsi/graphify/actions/workflows/ci.yml/badge.svg?branch=v3)](https://github.com/safishamsi/graphify/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/graphifyy)](https://pypi.org/project/graphifyy/)

**一个面向 AI 编码助手的技能。** 在 Claude Code、Codex、OpenCode 或 OpenClaw 中输入 `/graphify`,它会读取你的文件、构建知识图谱,并把原本不明显的结构关系还给你。更快理解代码库,找到架构决策背后的为什么
**一个面向 AI 编码助手的技能。** 在 Claude Code、Codex、OpenCode、OpenClaw、Factory Droid 或 Trae 中输入 `/graphify`,它会读取你的文件、构建知识图谱,并把原本不明显的结构关系还给你。更快理解代码库,找到架构决策背后的"为什么"

完全多模态。你可以直接丢进去代码、PDF、Markdown、截图、流程图、白板照片,甚至其他语言的图片 —— graphify 会用 Claude vision 从这些内容中提取概念和关系,并把它们连接到同一张图里。

Expand Down Expand Up @@ -33,7 +33,7 @@ graphify 分两轮执行。第一轮是确定性的 AST 提取,对代码文件

## 安装

**要求:** Python 3.10+,并且使用以下平台之一:[Claude Code](https://claude.ai/code)、[Codex](https://openai.com/codex)、[OpenCode](https://opencode.ai) 或 [OpenClaw](https://openclaw.ai)
**要求:** Python 3.10+,并且使用以下平台之一:[Claude Code](https://claude.ai/code)、[Codex](https://openai.com/codex)、[OpenCode](https://opencode.ai)、[OpenClaw](https://openclaw.ai)、[Factory Droid](https://factory.ai) 或 [Trae](https://trae.ai)

```bash
pip install graphifyy && graphify install
Expand All @@ -49,8 +49,11 @@ pip install graphifyy && graphify install
| Codex | `graphify install --platform codex` |
| OpenCode | `graphify install --platform opencode` |
| OpenClaw | `graphify install --platform claw` |
| Factory Droid | `graphify install --platform droid` |
| Trae | `graphify install --platform trae` |
| Trae CN | `graphify install --platform trae-cn` |

Codex 用户还需要在 `~/.codex/config.toml` 的 `[features]` 下打开 `multi_agent = true`,这样才能并行提取。OpenClaw 目前的并行 agent 支持还比较早期,所以使用顺序提取。
Codex 用户还需要在 `~/.codex/config.toml` 的 `[features]` 下打开 `multi_agent = true`,这样才能并行提取。OpenClaw 目前的并行 agent 支持还比较早期,所以使用顺序提取。Trae 使用 Agent 工具进行并行子代理调度,**不支持** PreToolUse hook,因此 AGENTS.md 是其常驻机制。

然后打开你的 AI 编码助手,输入:

Expand All @@ -68,14 +71,17 @@ Codex 用户还需要在 `~/.codex/config.toml` 的 `[features]` 下打开 `mult
| Codex | `graphify codex install` |
| OpenCode | `graphify opencode install` |
| OpenClaw | `graphify claw install` |
| Factory Droid | `graphify droid install` |
| Trae | `graphify trae install` |
| Trae CN | `graphify trae-cn install` |

**Claude Code** 会做两件事:
1. 在 `CLAUDE.md` 中写入一段规则,告诉 Claude 在回答架构问题前先读 `graphify-out/GRAPH_REPORT.md`
2. 安装一个 **PreToolUse hook**(写入 `settings.json`),在每次 `Glob` 和 `Grep` 前触发

如果知识图谱存在,Claude 会先看到:_"graphify: Knowledge graph exists. Read graphify-out/GRAPH_REPORT.md for god nodes and community structure before searching raw files."_ —— 这样 Claude 会优先按图谱导航,而不是一上来就 grep 整个项目。

**Codex、OpenCode、OpenClaw** 会把同样的规则写进项目根目录的 `AGENTS.md`。这些平台没有 PreToolUse hook,所以 `AGENTS.md` 是它们的常驻机制。
**Codex、OpenCode、OpenClaw、Factory Droid、Trae** 会把同样的规则写进项目根目录的 `AGENTS.md`。这些平台没有 PreToolUse hook,所以 `AGENTS.md` 是它们的常驻机制。

卸载时使用对应平台的 uninstall 命令即可(例如 `graphify claude uninstall`)。

Expand Down Expand Up @@ -146,6 +152,11 @@ graphify claude uninstall
graphify codex install # AGENTS.md(Codex)
graphify opencode install # AGENTS.md(OpenCode)
graphify claw install # AGENTS.md(OpenClaw)
graphify droid install # AGENTS.md(Factory Droid)
graphify trae install # AGENTS.md(Trae)
graphify trae uninstall
graphify trae-cn install # AGENTS.md(Trae CN)
graphify trae-cn uninstall
```

支持混合文件类型:
Expand Down
Loading