{"id":48389153,"url":"https://github.com/safishamsi/graphify","last_synced_at":"2026-05-07T21:01:29.807Z","repository":{"id":349016445,"uuid":"1200597263","full_name":"safishamsi/graphify","owner":"safishamsi","description":"AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs, papers, images, or videos into a queryable knowledge graph. App code + database schema + infrastructure in one graph.","archived":false,"fork":false,"pushed_at":"2026-05-04T11:40:44.000Z","size":1262,"stargazers_count":42310,"open_issues_count":211,"forks_count":4622,"subscribers_count":166,"default_branch":"v6","last_synced_at":"2026-05-04T12:40:05.036Z","etag":null,"topics":["antigravity","claude-code","codex","gemini","graphrag","knowledge-graph","leiden","openclaw","rag","skills","tree-sitter"],"latest_commit_sha":null,"homepage":"https://graphifylabs.ai/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/safishamsi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"safishamsi"}},"created_at":"2026-04-03T15:49:07.000Z","updated_at":"2026-05-04T12:38:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/safishamsi/graphify","commit_stats":null,"previous_names":["safishamsi/graphify"],"tags_count":87,"template":false,"template_full_name":null,"purl":"pkg:github/safishamsi/graphify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/safishamsi%2Fgraphify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/safishamsi%2Fgraphify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/safishamsi%2Fgraphify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/safishamsi%2Fgraphify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/safishamsi","download_url":"https://codeload.github.com/safishamsi/graphify/tar.gz/refs/heads/v6","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/safishamsi%2Fgraphify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32755926,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["antigravity","claude-code","codex","gemini","graphrag","knowledge-graph","leiden","openclaw","rag","skills","tree-sitter"],"created_at":"2026-04-05T23:10:17.797Z","updated_at":"2026-05-07T21:01:29.786Z","avatar_url":"https://github.com/safishamsi.png","language":"Python","funding_links":["https://github.com/sponsors/safishamsi"],"categories":["Python","AI拓展工具","🎯 Agent Skills","CLIs","🧠 Agent Skills"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://graphifylabs.ai\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/safishamsi/graphify/v4/docs/logo-text.svg\" width=\"260\" height=\"64\" alt=\"Graphify\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  🇺🇸 \u003ca href=\"README.md\"\u003eEnglish\u003c/a\u003e | 🇨🇳 \u003ca href=\"docs/translations/README.zh-CN.md\"\u003e简体中文\u003c/a\u003e | 🇯🇵 \u003ca href=\"docs/translations/README.ja-JP.md\"\u003e日本語\u003c/a\u003e | 🇰🇷 \u003ca href=\"docs/translations/README.ko-KR.md\"\u003e한국어\u003c/a\u003e | 🇩🇪 \u003ca href=\"docs/translations/README.de-DE.md\"\u003eDeutsch\u003c/a\u003e | 🇫🇷 \u003ca href=\"docs/translations/README.fr-FR.md\"\u003eFrançais\u003c/a\u003e | 🇪🇸 \u003ca href=\"docs/translations/README.es-ES.md\"\u003eEspañol\u003c/a\u003e | 🇮🇳 \u003ca href=\"docs/translations/README.hi-IN.md\"\u003eहिन्दी\u003c/a\u003e | 🇧🇷 \u003ca href=\"docs/translations/README.pt-BR.md\"\u003ePortuguês\u003c/a\u003e | 🇷🇺 \u003ca href=\"docs/translations/README.ru-RU.md\"\u003eРусский\u003c/a\u003e | 🇸🇦 \u003ca href=\"docs/translations/README.ar-SA.md\"\u003eالعربية\u003c/a\u003e | 🇮🇹 \u003ca href=\"docs/translations/README.it-IT.md\"\u003eItaliano\u003c/a\u003e | 🇵🇱 \u003ca href=\"docs/translations/README.pl-PL.md\"\u003ePolski\u003c/a\u003e | 🇳🇱 \u003ca href=\"docs/translations/README.nl-NL.md\"\u003eNederlands\u003c/a\u003e | 🇹🇷 \u003ca href=\"docs/translations/README.tr-TR.md\"\u003eTürkçe\u003c/a\u003e | 🇺🇦 \u003ca href=\"docs/translations/README.uk-UA.md\"\u003eУкраїнська\u003c/a\u003e | 🇻🇳 \u003ca href=\"docs/translations/README.vi-VN.md\"\u003eTiếng Việt\u003c/a\u003e | 🇮🇩 \u003ca href=\"docs/translations/README.id-ID.md\"\u003eBahasa Indonesia\u003c/a\u003e | 🇸🇪 \u003ca href=\"docs/translations/README.sv-SE.md\"\u003eSvenska\u003c/a\u003e | 🇬🇷 \u003ca href=\"docs/translations/README.el-GR.md\"\u003eΕλληνικά\u003c/a\u003e | 🇷🇴 \u003ca href=\"docs/translations/README.ro-RO.md\"\u003eRomână\u003c/a\u003e | 🇨🇿 \u003ca href=\"docs/translations/README.cs-CZ.md\"\u003eČeština\u003c/a\u003e | 🇫🇮 \u003ca href=\"docs/translations/README.fi-FI.md\"\u003eSuomi\u003c/a\u003e | 🇩🇰 \u003ca href=\"docs/translations/README.da-DK.md\"\u003eDansk\u003c/a\u003e | 🇳🇴 \u003ca href=\"docs/translations/README.no-NO.md\"\u003eNorsk\u003c/a\u003e | 🇭🇺 \u003ca href=\"docs/translations/README.hu-HU.md\"\u003eMagyar\u003c/a\u003e | 🇹🇭 \u003ca href=\"docs/translations/README.th-TH.md\"\u003eภาษาไทย\u003c/a\u003e | 🇹🇼 \u003ca href=\"docs/translations/README.zh-TW.md\"\u003e繁體中文\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://safishamsi.gumroad.com/l/qetvlo\"\u003e\u003cimg src=\"https://img.shields.io/badge/Book-The%20Memory%20Layer-2ea44f?style=flat\u0026logo=gitbook\u0026logoColor=white\" alt=\"The Memory Layer\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/safishamsi/graphify/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/safishamsi/graphify/actions/workflows/ci.yml/badge.svg?branch=v4\" alt=\"CI\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/graphifyy/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/graphifyy\" alt=\"PyPI\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://pepy.tech/project/graphifyy\"\u003e\u003cimg src=\"https://static.pepy.tech/badge/graphifyy\" alt=\"Downloads\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sponsors/safishamsi\"\u003e\u003cimg src=\"https://img.shields.io/badge/sponsor-safishamsi-ea4aaa?logo=github-sponsors\" alt=\"Sponsor\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.linkedin.com/in/safi-shamsi\"\u003e\u003cimg src=\"https://img.shields.io/badge/LinkedIn-Safi%20Shamsi-0077B5?logo=linkedin\" alt=\"LinkedIn\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://star-history.com/#safishamsi/graphify\u0026Date\"\u003e\n    \u003cimg src=\"https://api.star-history.com/svg?repos=safishamsi/graphify\u0026type=Date\" alt=\"Star History Chart\" width=\"600\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nType `/graphify` in your AI coding assistant and it maps your entire project — code, docs, PDFs, images, videos — into a knowledge graph you can query instead of grepping through files.\n\nWorks in Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro, Pi, and Google Antigravity.\n\n```\n/graphify .\n```\n\nThat's it. You get three files:\n\n```\ngraphify-out/\n├── graph.html       open in any browser — click nodes, filter, search\n├── GRAPH_REPORT.md  the highlights: key concepts, surprising connections, suggested questions\n└── graph.json       the full graph — query it anytime without re-reading your files\n```\n\n---\n\n## Install\n\n**Requires Python 3.10+**\n\n```bash\nuv tool install graphifyy \u0026\u0026 graphify install\n# or: pipx install graphifyy \u0026\u0026 graphify install\n# or: pip install graphifyy \u0026\u0026 graphify install\n```\n\n\u003e **Official package:** The PyPI package is `graphifyy` (double-y). Other `graphify*` packages on PyPI are not affiliated. The CLI command is still `graphify`.\n\n\u003e **`graphify: command not found`?** Use `uv tool install graphifyy` or `pipx install graphifyy` — both put the CLI on PATH automatically. With plain `pip`, add `~/.local/bin` (Linux) or `~/Library/Python/3.x/bin` (Mac) to your PATH, or run `python -m graphify`.\n\n### Pick your platform\n\n| Platform | Install command |\n|----------|----------------|\n| Claude Code (Linux/Mac) | `graphify install` |\n| Claude Code (Windows) | `graphify install --platform windows` |\n| Codex | `graphify install --platform codex` |\n| OpenCode | `graphify install --platform opencode` |\n| GitHub Copilot CLI | `graphify install --platform copilot` |\n| VS Code Copilot Chat | `graphify vscode install` |\n| Aider | `graphify install --platform aider` |\n| OpenClaw | `graphify install --platform claw` |\n| Factory Droid | `graphify install --platform droid` |\n| Trae | `graphify install --platform trae` |\n| Trae CN | `graphify install --platform trae-cn` |\n| Gemini CLI | `graphify install --platform gemini` |\n| Hermes | `graphify install --platform hermes` |\n| Kiro IDE/CLI | `graphify kiro install` |\n| Pi coding agent | `graphify install --platform pi` |\n| Cursor | `graphify cursor install` |\n| Google Antigravity | `graphify antigravity install` |\n\n\u003e Codex users: also add `multi_agent = true` under `[features]` in `~/.codex/config.toml`.\n\u003e Codex uses `$graphify` instead of `/graphify`.\n\n---\n\n## Make your assistant always use the graph\n\nRun this once in your project after building a graph:\n\n| Platform | Command |\n|----------|---------|\n| Claude Code | `graphify claude install` |\n| Codex | `graphify codex install` |\n| OpenCode | `graphify opencode install` |\n| GitHub Copilot CLI | `graphify copilot install` |\n| VS Code Copilot Chat | `graphify vscode install` |\n| Aider | `graphify aider install` |\n| OpenClaw | `graphify claw install` |\n| Factory Droid | `graphify droid install` |\n| Trae | `graphify trae install` |\n| Trae CN | `graphify trae-cn install` |\n| Cursor | `graphify cursor install` |\n| Gemini CLI | `graphify gemini install` |\n| Hermes | `graphify hermes install` |\n| Kiro IDE/CLI | `graphify kiro install` |\n| Pi coding agent | `graphify pi install` |\n| Google Antigravity | `graphify antigravity install` |\n\nThis writes a small config file that tells your assistant to read `GRAPH_REPORT.md` before answering questions about your codebase. On platforms that support hooks (Claude Code, Codex, Gemini CLI), a hook fires automatically before every file-read call — your assistant navigates by the graph instead of grepping through everything.\n\nUninstall with the matching command (e.g. `graphify claude uninstall`).\n\n---\n\n## What's in the report\n\n- **God nodes** — the most-connected concepts in your project. Everything flows through these.\n- **Surprising connections** — links between things that live in different files or modules. Ranked by how unexpected they are.\n- **The \"why\"** — inline comments (`# NOTE:`, `# WHY:`, `# HACK:`), docstrings, and design rationale from docs are extracted as separate nodes linked to the code they explain.\n- **Suggested questions** — 4–5 questions the graph is uniquely positioned to answer.\n- **Confidence tags** — every inferred relationship is marked `EXTRACTED`, `INFERRED`, or `AMBIGUOUS`. You always know what was found vs guessed.\n\n---\n\n## What files it handles\n\n| Type | Extensions |\n|------|-----------|\n| Code (25 languages) | `.py .ts .js .jsx .tsx .go .rs .java .c .cpp .rb .cs .kt .scala .php .swift .lua .zig .ps1 .ex .exs .m .jl .vue .svelte .sql` |\n| Docs | `.md .mdx .html .txt .rst .yaml .yml` |\n| Office | `.docx .xlsx` (requires `pip install graphifyy[office]`) |\n| PDFs | `.pdf` |\n| Images | `.png .jpg .webp .gif` |\n| Video / Audio | `.mp4 .mov .mp3 .wav` and more (requires `pip install graphifyy[video]`) |\n| YouTube / URLs | any video URL (requires `pip install graphifyy[video]`) |\n\nCode is extracted locally with no API calls (AST via tree-sitter). Everything else goes through your AI assistant's model API.\n\n---\n\n## Common commands\n\n```bash\n/graphify .                        # build graph for current folder\n/graphify ./docs --update          # re-extract only changed files\n/graphify . --cluster-only         # rerun clustering without re-extracting\n/graphify . --no-viz               # skip the HTML, just the report + JSON\n/graphify . --wiki                 # build a markdown wiki from the graph\n\n/graphify query \"what connects auth to the database?\"\n/graphify path \"UserService\" \"DatabasePool\"\n/graphify explain \"RateLimiter\"\n\n/graphify add https://arxiv.org/abs/1706.03762   # fetch a paper and add it\n/graphify add \u003cyoutube-url\u003e                       # transcribe and add a video\n\ngraphify hook install              # auto-rebuild on git commit\ngraphify merge-graphs a.json b.json              # combine two graphs\n```\n\nSee the [full command reference](#full-command-reference) below.\n\n---\n\n## Ignoring files\n\nCreate a `.graphifyignore` in your project root — same syntax as `.gitignore`, including `!` negation:\n\n```\n# .graphifyignore\nnode_modules/\ndist/\n*.generated.py\n\n# only index src/, ignore everything else\n*\n!src/\n!src/**\n```\n\n---\n\n## Team setup\n\n`graphify-out/` is meant to be committed to git so everyone on the team starts with a map.\n\n**Recommended `.gitignore` additions:**\n```\ngraphify-out/manifest.json    # mtime-based, breaks after git clone\ngraphify-out/cost.json        # local only\n# graphify-out/cache/         # optional: commit for speed, skip to keep repo small\n```\n\n**Workflow:**\n1. One person runs `/graphify .` and commits `graphify-out/`.\n2. Everyone pulls — their assistant reads the graph immediately.\n3. Run `graphify hook install` to auto-rebuild after each commit (AST only, no API cost).\n4. When docs or papers change, run `/graphify --update` to refresh those nodes.\n\n---\n\n## Using the graph directly\n\n```bash\n# query the graph from the terminal\ngraphify query \"show the auth flow\"\ngraphify query \"what connects DigestAuth to Response?\" --graph graphify-out/graph.json\n\n# expose the graph as an MCP server (for repeated tool-call access)\npython -m graphify.serve graphify-out/graph.json\n```\n\nThe MCP server gives your assistant structured access: `query_graph`, `get_node`, `get_neighbors`, `shortest_path`.\n\n\u003e **WSL / Linux note:** Ubuntu ships `python3`, not `python`. Use a venv to avoid conflicts:\n\u003e ```bash\n\u003e python3 -m venv .venv \u0026\u0026 .venv/bin/pip install \"graphifyy[mcp]\"\n\u003e ```\n\n---\n\n## Privacy\n\n- **Code files** — processed locally via tree-sitter. Nothing leaves your machine.\n- **Video / audio** — transcribed locally with faster-whisper. Nothing leaves your machine.\n- **Docs, PDFs, images** — sent to your AI assistant's model API (Anthropic, OpenAI, etc.) using your own API key.\n- No telemetry, no usage tracking, no analytics.\n\n---\n\n## Full command reference\n\n```\n/graphify                          # run on current directory\n/graphify ./raw                    # run on a specific folder\n/graphify ./raw --mode deep        # more aggressive relationship extraction\n/graphify ./raw --update           # re-extract only changed files\n/graphify ./raw --directed         # preserve edge direction\n/graphify ./raw --cluster-only     # rerun clustering on existing graph\n/graphify ./raw --no-viz           # skip HTML visualization\n/graphify ./raw --obsidian         # generate Obsidian vault\n/graphify ./raw --wiki             # build agent-crawlable markdown wiki\n/graphify ./raw --svg              # export graph.svg\n/graphify ./raw --graphml          # export for Gephi / yEd\n/graphify ./raw --neo4j            # generate cypher.txt for Neo4j\n/graphify ./raw --neo4j-push bolt://localhost:7687\n/graphify ./raw --watch            # auto-sync as files change\n/graphify ./raw --mcp              # start MCP stdio server\n\n/graphify add https://arxiv.org/abs/1706.03762\n/graphify add \u003cvideo-url\u003e\n/graphify add https://... --author \"Name\" --contributor \"Name\"\n\n/graphify query \"what connects attention to the optimizer?\"\n/graphify query \"...\" --dfs --budget 1500\n/graphify path \"DigestAuth\" \"Response\"\n/graphify explain \"SwinTransformer\"\n\ngraphify hook install              # post-commit + post-checkout hooks\ngraphify hook uninstall\ngraphify hook status\n\ngraphify claude install / uninstall\ngraphify codex install / uninstall\ngraphify opencode install\ngraphify cursor install / uninstall\ngraphify gemini install / uninstall\ngraphify copilot install / uninstall\ngraphify aider install / uninstall\ngraphify claw install / uninstall\ngraphify droid install / uninstall\ngraphify trae install / uninstall\ngraphify trae-cn install / uninstall\ngraphify hermes install / uninstall\ngraphify kiro install / uninstall\ngraphify antigravity install / uninstall\n\ngraphify clone https://github.com/karpathy/nanoGPT\ngraphify merge-graphs a.json b.json --out merged.json\ngraphify watch ./src\ngraphify check-update ./src\ngraphify update ./src\ngraphify cluster-only ./my-project\n```\n\n---\n\n## Learn more\n\n- [How it works](docs/how-it-works.md) — the extraction pipeline, community detection, confidence scoring, benchmarks\n- [ARCHITECTURE.md](ARCHITECTURE.md) — module breakdown, how to add a language\n- [Optional integrations](docs/docker-mcp-sqlite.md) — Docker MCP Toolkit + SQLite\n\n---\n\n## Built on graphify — Penpax\n\n[**Penpax**](https://graphifylabs.ai) is the always-on layer built on top of graphify — it applies the same graph approach to your entire working life: meetings, browser history, emails, files, and code, updating continuously in the background.\n\nBuilt for people whose work lives across hundreds of conversations and documents they can never fully reconstruct. No cloud, fully on-device.\n\n**Free trial launching soon.** [Join the waitlist →](https://graphifylabs.ai)\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003eContributing\u003c/summary\u003e\n\n**Worked examples** are the most useful contribution. Run `/graphify` on a real corpus, save the output to `worked/{slug}/`, write an honest `review.md` covering what the graph got right and wrong, and open a PR.\n\n**Extraction bugs** — open an issue with the input file, the cache entry (`graphify-out/cache/`), and what was missed or wrong.\n\nSee [ARCHITECTURE.md](ARCHITECTURE.md) for module responsibilities and how to add a language.\n\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsafishamsi%2Fgraphify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsafishamsi%2Fgraphify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsafishamsi%2Fgraphify/lists"}