هزینه توکن عامل‌ها را ۸۰٪ کاهش دهید. Graphify Cloud یک حافظهٔ همیشه‌روشن است که عامل‌های شما را مدیریت می‌کند، کیفیت کد را بالا نگه می‌دارد و درستی را با وارسی صوری اثبات می‌کند. یک دورهٔ آزمایشی رایگان ۱۴ روزه را آغاز کنید →

در دستیار کدنویسی هوش مصنوعی خود /graphify را تایپ کنید تا کل پروژهٔ شما (کد، مستندات، فایل‌های PDF، تصاویر، ویدیوها) را به یک گراف دانش نگاشت کند که می‌توانید به‌جای grep کردن در فایل‌ها از آن پرس‌وجو کنید.

• نگاشت کد رایگان و کاملاً محلی. کد با درخت نحو انتزاعی (AST) tree-sitter تجزیه می‌شود: قطعی، بدون مدل زبانی، و هیچ‌چیز از دستگاه شما خارج نمی‌شود. (مستندات، فایل‌های PDF، تصاویر و ویدیو برای یک گذر معنایی از مدل دستیار شما یا یک کلید API پیکربندی‌شده استفاده می‌کنند.)
• هر یال توضیح داده می‌شود. هر اتصال با EXTRACTED (صریح در منبع) یا INFERRED (برطرف‌شده توسط graphify) برچسب می‌خورد، تا بتوانید آنچه را مستقیماً خوانده شده از آنچه استنتاج شده تشخیص دهید.
• یک نمایهٔ برداری نیست. بدون تعبیه‌ها، بدون انبار برداری: یک گراف واقعی که آن را پیمایش می‌کنید. سؤالی بپرسید، مسیر میان دو چیز را ردیابی کنید، یا یک مفهوم را توضیح دهید.

کدبیس FastAPI که توسط graphify نگاشت شده است. هر گره یک مفهوم است، رنگ‌ها جامعه‌های شناسایی‌شده هستند، و همهٔ آن در graph.html قابل کلیک است.

شروع کنید (۳۰ ثانیه):

uv tool install graphifyy      # install the CLI (or: pipx install graphifyy)
graphify install               # register the skill with your AI assistant

سپس، در دستیار هوش مصنوعی خود:

/graphify .

همین. شما سه فایل دریافت می‌کنید:

graphify-out/
├── graph.html       open in any browser — click nodes, filter, search
├── GRAPH_REPORT.md  the highlights: key concepts, surprising connections, suggested questions
└── graph.json       the full graph — query it anytime without re-reading your files

گراف ذخیره‌شده شامل graph.schema_version است تا یکپارچه‌سازی‌ها بتوانند تغییرات ناسازگار قالب را تشخیص دهند، به‌علاوهٔ graph.graphify_version که نسخهٔ Graphify تولیدکنندهٔ آن را مشخص می‌کند.

کار می‌کند در Claude Code، Cursor، Codex، Gemini CLI، GitHub Copilot و ۱۵+ مورد دیگر — پلتفرم خود را انتخاب کنید.

راهنماها و مرجع کامل در docs.graphify.com قرار دارند:

• Quickstart — نخستین گراف خود را بسازید
• CLI reference — هر فرمان و هر پرچم
• Ask better graph questions — الگوهای پرس‌وجو
• Configuration — متغیرهای محیطی و تنظیم
• Supported inputs — زبان‌ها و انواع فایل
• Team workflows و PR review
• Troubleshooting و How it works

پس از ساخت گراف، به‌جای خواندن فایل‌ها از آن پرس‌وجو می‌کنید. خروجی واقعی، اجرای graphify روی کدبیس FastAPI که در بالا نشان داده شد:

$ graphify explain "APIRouter"
Node: APIRouter
  Source:    routing.py L2210
  Community: 2
  Degree:    47

Connections (47):
  --> RequestValidationError [uses] [INFERRED]
  --> Dependant [uses] [INFERRED]
  --> .get() [method] [EXTRACTED]
  <-- __init__.py [imports] [EXTRACTED]
  ...

$ graphify path "FastAPI" "ModelField"
Shortest path (3 hops):
  FastAPI --uses--> DefaultPlaceholder <--references-- get_request_handler() --references--> ModelField

هر یال یک برچسب اطمینان حمل می‌کند (EXTRACTED = صریح در منبع، INFERRED = مشتق‌شده از طریق برطرف‌سازی)، تا بتوانید آنچه را مستقیماً خوانده شده از آنچه استنتاج شده تشخیص دهید. graphify query "<question>" یک زیرگراف محدودشده برای یک سؤال به زبان ساده بازمی‌گرداند، و graphify path A B ردیابی می‌کند که هر دو چیز چگونه به هم متصل می‌شوند.

آنچه به‌صورت آماده دریافت می‌کنید:

هر سیستم روی همان بستر با همان مدل و همان بودجه‌ها اجرا شد، و توسط یک داور که به‌صورت کور در برابر یک داور دوم اعتبارسنجی شده بود امتیازدهی شد (توافق ۹۰٫۶٪، کاپای کوهن ۰٫۸۱). جداول کامل هر سیستم، نتیجهٔ هوش کد، و فرمان‌های بازتولید: BENCHMARKS.md.

نصب سریع macOS (Homebrew):

brew install python@3.12 uv

نصب سریع Windows:

winget install astral-sh.uv

Ubuntu/Debian:

sudo apt install python3.12 python3-pip pipx
# or install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh

مخزن منبع رسمی Graphify-Labs/graphify است.

گام ۱ — بسته را نصب کنید:

# Recommended (isolated env; if 'graphify' isn't found after, run: uv tool update-shell):
uv tool install graphifyy

# Alternatives:
pipx install graphifyy
pip install graphifyy  # may need PATH setup — see note below

گام ۲ — مهارت را در دستیار هوش مصنوعی خود ثبت کنید:

graphify install

همین. دستیار هوش مصنوعی خود را باز کنید و /graphify . را تایپ کنید

برای نصب مهارت دستیار در مخزن کنونی به‌جای نمایهٔ کاربری خود، --project را اضافه کنید:

graphify install --project
graphify install --project --platform codex

نصب‌های محدودشده به پروژه زیر دایرکتوری کنونی نوشته می‌شوند، برای مثال .claude/skills/graphify/SKILL.md یا .agents/skills/graphify/SKILL.md (به‌علاوهٔ یک جانبی references/ که مهارت بنا به تقاضا بارگذاری می‌کند)، و یک راهنمای git add را برای فایل‌هایی که می‌توان کامیت کرد چاپ می‌کنند. فرمان‌های هر پلتفرم که از نصب‌های محدودشده به پروژه پشتیبانی می‌کنند همان پرچم را می‌پذیرند، برای مثال graphify claude install --project یا graphify codex install --project.

این را یک بار در پروژهٔ خود پس از ساخت یک گراف اجرا کنید:

graphify <platform> install را یک بار در پروژهٔ خود اجرا کنید، برای مثال graphify claude install یا graphify codex install (یا graphify install --platform <name>).

این یک فایل پیکربندی کوچک می‌نویسد که به دستیار شما می‌گوید برای پرسش‌های مربوط به کدبیس به گراف دانش رجوع کند و پرس‌وجوهای محدودشده مانند graphify query "<question>" را بر خواندن کل گزارش یا grep کردن فایل‌های خام ترجیح دهد.

• پلتفرم‌های قلاب (Claude Code، Gemini CLI): یک قلاب به‌طور خودکار پیش از فراخوان‌های ابزار سبک-جست‌وجو (و در Claude Code، پیش از خواندن فایل‌های منبع یک‌به‌یک از طریق ابزارهای Read/Glob) فعال می‌شود و دستیار شما را به‌سوی مسیر گراف هدایت می‌کند.
• پلتفرم‌های فایل-دستورالعمل (Codex، OpenCode، Cursor و غیره): فایل‌های دستورالعمل پایدار (AGENTS.md، .cursor/rules/ و غیره) همان راهنمایی پرس‌وجو-نخست را فراهم می‌کنند.

GRAPH_REPORT.md همچنان برای بازبینی گستردهٔ معماری در دسترس است.

CodeBuddy همان دو کاری را که Claude Code انجام می‌دهد انجام می‌دهد: یک بخش CODEBUDDY.md می‌نویسد که به CodeBuddy می‌گوید پیش از پاسخ به پرسش‌های معماری graphify-out/GRAPH_REPORT.md را بخواند، و قلاب‌های PreToolUse (.codebuddy/settings.json) را نصب می‌کند که پیش از فرمان‌های جست‌وجوی Bash و خواندن فایل‌ها فعال می‌شوند و به‌جای آن به‌سوی graphify query هدایت می‌کنند.

Codex در AGENTS.md می‌نویسد، که همان چیزی است که در عمل راهنمایی همیشه‌روشن گراف را روی این پلتفرم حمل می‌کند. graphify codex install همچنین یک قلاب PreToolUse را در .codex/hooks.json (graphify hook-check) ثبت می‌کند، اما آن ورودی عامدانه یک عمل بی‌اثر است: Codex Desktop hookSpecificOutput.additionalContext را روی PreToolUse رد می‌کند، بنابراین انتشار یک هدایت در آنجا فراخوان‌های ابزار Bash را خراب می‌کند. برخلاف Claude Code، که در آن قلاب (graphify hook-guard) هدایت را انجام می‌دهد، در Codex قلاب فعال می‌شود و عمداً کاری انجام نمی‌دهد، و AGENTS.md سازوکار همیشه‌روشن است.

Kilo Code مهارت Graphify را در ~/.config/kilo/skills/graphify/SKILL.md و یک فرمان بومی /graphify را در ~/.config/kilo/command/graphify.md نصب می‌کند. graphify kilo install همچنین AGENTS.md را به‌علاوهٔ یک افزونهٔ بومی tool.execute.before (.kilo/plugins/graphify.js + ثبت .kilo/kilo.json یا .kilo/kilo.jsonc) می‌نویسد تا Kilo از طریق پیکربندی بومی .kilo همان رفتار یادآوری همیشه‌روشن گراف را دریافت کند.

Cursor فایل .cursor/rules/graphify.mdc را با alwaysApply: true می‌نویسد، بنابراین Cursor آن را به‌طور خودکار در هر گفت‌وگو می‌گنجاند، بدون نیاز به قلاب.

برای حذف graphify از همهٔ پلتفرم‌ها به‌یک‌باره: graphify uninstall (برای حذف graphify-out/ نیز --purge را اضافه کنید). یا از فرمان هر پلتفرم استفاده کنید (برای مثال graphify claude uninstall).

GRAPH_REPORT.md گره‌های خدا، جامعه‌ها و مسیرهای کلیدی را برای بازبینی گستردهٔ معماری خلاصه می‌کند. اینکه گراف چگونه ساخته می‌شود و چه چیزی در بر دارد: How graphify works.

graphify حدود ۴۰ زبان برنامه‌نویسی را به‌صورت محلی با AST tree-sitter تجزیه می‌کند، و مستندات، فایل‌های PDF، تصاویر و صوت/ویدیو را از طریق یک گذر معنایی اختیاری نگاشت می‌کند. فهرست کامل: Supported inputs.

/graphify .                        # build graph for current folder
/graphify ./docs --update          # re-extract only changed files
/graphify . --cluster-only         # rerun clustering without re-extracting
/graphify . --cluster-only --resolution 1.5      # more granular communities
/graphify . --cluster-only --exclude-hubs 99     # suppress utility super-hubs from god-node rankings
/graphify . --no-viz               # skip the HTML, just the report + JSON
/graphify . --wiki                 # build a markdown wiki from the graph
graphify export callflow-html      # Mermaid architecture/call-flow HTML (auto-regenerates on every git commit if hook is installed)

/graphify query "what connects auth to the database?"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"

/graphify add https://arxiv.org/abs/1706.03762   # fetch a paper and add it
/graphify add <youtube-url>                       # transcribe and add a video

graphify hook install              # auto-rebuild on commit + branch checkout (run `graphify update .` after `git pull` — see "Recommended workflow" below)
graphify merge-graphs a.json b.json              # combine two graphs

graphify prs                       # PR dashboard: CI state, review status, worktree mapping
graphify prs 42                    # deep dive on PR #42 with graph impact
graphify prs --triage              # AI ranks your review queue (uses whatever backend is configured)
graphify prs --conflicts           # PRs sharing graph communities — merge-order risk

مرجع کامل فرمان‌ها را در زیر ببینید.

graphify به .gitignore احترام می‌گذارد و از الگوهای --exclude و یک .graphifyignore پروژه پشتیبانی می‌کند. جزئیات: Configuration.

گراف را کامیت یا به اشتراک بگذارید تا کل تیم شما از همان زمینه پرس‌وجو کند، و درخواست‌های کشش را با زمینهٔ گراف بازبینی کنید. Share context with your team و Review pull requests را ببینید.

فراتر از دستیار هوش مصنوعی خود، graph.json را مستقیماً از CLI با graphify query، graphify path و graphify explain پرس‌وجو کنید. Ask better graph questions و query reference را ببینید.

بک‌اندها، کلیدهای API، رفتار قلاب و تنظیم از طریق متغیرهای محیطی کنترل می‌شوند. جدول کامل: Configuration.

• فایل‌های کد — به‌صورت محلی از طریق tree-sitter پردازش می‌شوند. هیچ‌چیز از دستگاه شما خارج نمی‌شود. یک پیکرهٔ تنها-کد به هیچ کلید API نیاز ندارد — graphify extract کاملاً آفلاین اجرا می‌شود. روی یک مخزن ترکیبی، --code-only را اضافه کنید تا فقط کد را نمایه کنید و از مستندات/فایل‌های PDF/تصاویری که در غیر این صورت به یک مدل زبانی نیاز دارند صرف‌نظر کنید.
• ویدیو / صوت — به‌صورت محلی با faster-whisper رونویسی می‌شود. هیچ‌چیز از دستگاه شما خارج نمی‌شود.
• مستندات، فایل‌های PDF، تصاویر — برای استخراج معنایی به دستیار هوش مصنوعی شما ارسال می‌شوند (از طریق مهارت /graphify، با استفاده از هر مدلی که نشست IDE شما اجرا می‌کند). graphify extract بدون‌واسط به GEMINI_API_KEY / GOOGLE_API_KEY (Gemini)، MOONSHOT_API_KEY (Kimi)، ANTHROPIC_API_KEY (Claude)، OPENAI_API_KEY (OpenAI)، DEEPSEEK_API_KEY (DeepSeek)، یک نمونهٔ در حال اجرای Ollama (OLLAMA_BASE_URL)، اعتبارنامه‌های AWS از طریق زنجیرهٔ استاندارد ارائه‌دهنده (Bedrock - بدون نیاز به کلید API، از IAM استفاده می‌کند)، یا باینری claude CLI (Claude Code - بدون نیاز به کلید API، از اشتراک Claude شما استفاده می‌کند) نیاز دارد. پرچم --dedup-llm از همان کلید استفاده می‌کند.
• اقامتگاه داده — graphify extract به‌طور خودکار بر اساس کلید API تنظیم‌شده تشخیص می‌دهد از کدام ارائه‌دهنده استفاده کند (اولویت: Gemini → Kimi → Claude → OpenAI → DeepSeek → Azure → Bedrock → Ollama). برای کدی با الزامات اقامتگاه داده، از --backend ollama (کاملاً محلی) استفاده کنید یا یک پرچم --backend صریح بدهید. Kimi (MOONSHOT_API_KEY) به سرورهای Moonshot AI در چین مسیریابی می‌کند.
• بدون سنجش از راه دور، بدون ردیابی استفاده، بدون تحلیل.
• ثبت پرس‌وجو — هر فراخوان graphify query، graphify path، graphify explain و MCP query_graph در ~/.cache/graphify-queries.log با قالب JSON Lines ثبت می‌شود (برچسب زمانی، سؤال، پیکره، گره‌های بازگردانده‌شده، مدت). پاسخ‌های کامل زیرگراف به‌طور پیش‌فرض ذخیره نمی‌شوند. برای انصراف GRAPHIFY_QUERY_LOG_DISABLE=1 را تنظیم کنید، یا GRAPHIFY_QUERY_LOG=/dev/null را برای خاموش کردن بدون غیرفعال کردن مسیر کد.

مشکلات رایج نصب و استخراج و راه‌حل‌های آن‌ها: Troubleshooting.

هر فرمان و هر پرچم، با مثال: CLI reference.

• docs.graphify.com — مستندات کامل: راهنماها، مرجع فرمان‌ها و یکپارچه‌سازی‌ها
• How it works — خط لولهٔ استخراج، شناسایی جامعه، امتیازدهی اطمینان، محک‌ها
• ARCHITECTURE.md — تفکیک ماژول‌ها، چگونگی افزودن یک زبان
• Optional integrations — Docker MCP Toolkit + SQLite
• The Memory Layer — کتاب دربارهٔ ایده‌های پشت graphify، معماری از ابتدا تا انتها

Graphify Cloud لایهٔ همیشه‌روشنی است که بر فراز graphify ساخته شده است. به‌جای گرافی که بنا به تقاضا برای هر پوشه بازسازی می‌کنید، یک گراف زندهٔ واحد را در سراسر چرخهٔ عمر توسعهٔ نرم‌افزار شما نگه می‌دارد:

• ۸۰٪ توکن کمتر — حافظهٔ همیشه‌روشن یعنی عامل‌های شما در هر نشست از بازخواندن و بازتوضیح کدبیس دست می‌کشند.
• مونوریپو و چند-مخزنی — یک گراف متصل واحد در سراسر هر سرویس و مخزن، نه یک گراف برای هر پوشه.
• وارسی صوری — ناوردایی‌های معماری و وابستگی را در برابر گراف زنده بررسی کنید.
• بازبینی کد با نگاهی از بالا به SDLC شما — ببینید چگونه یک تغییر در کل سیستم موج می‌اندازد پیش از آنکه ادغام کنید.
• اتصال‌دهنده‌های SDLC — Sentry، Jira و موارد دیگر را وارد کنید، تا رخدادها، تیکت‌ها و کد در یک گراف زندگی کنند.
• همیشه‌روشن — به‌طور پیوسته در پس‌زمینه در سراسر کد، مستندات و جلسات به‌روزرسانی می‌شود.

یک دورهٔ آزمایشی رایگان ۱۴ روزه را در app.graphify.com آغاز کنید →

مشارکت‌ها خوش‌آمد هستند. برای راه‌اندازی توسعه، فرمان‌های آزمون و برابری با CI، گردش‌کار git، و اینکه چه چیزی یک مشارکت قوی را می‌سازد (مثال‌های عملی و گزارش‌های باگ استخراج مفیدترین‌ها هستند) CONTRIBUTING.md را ببینید. معماری و چگونگی افزودن یک زبان: ARCHITECTURE.md.

تازه‌وارد هستید؟ در Discord یا در GitHub Discussions سلام کنید.

ساخته‌شده با contrib.rocks.

این فایل راهنما به ۳۲ زبان در دسترس است. از تعویض‌کنندهٔ زبان در بالای این فایل استفاده کنید تا آن را به زبان خود بخوانید، یا docs/translations/ را مرور کنید. برای بهبود یک ترجمه یا افزودن یک ترجمهٔ جدید، یک درخواست کشش در برابر فایل متناظر آنجا باز کنید.

در حال ساخت چیزی در اکوسیستم graphify هستید؟ این تشویق می‌شود. اگر پروژهٔ شما از «graphify» در نام خود استفاده می‌کند (برای مثال graphify-dashboard یا graphify-action)، لطفاً یک یادداشت کوتاه به فایل راهنمای خود اضافه کنید که روشن کند آن ساختهٔ جامعه است و وابسته به Graphify Labs نیست و توسط آن تأیید نشده است. «graphify» و نشان graphify علامت‌های Graphify Labs هستند؛ لطفاً آن‌ها را به‌گونه‌ای که وضعیت رسمی را القا کند به کار نبرید.