graphify

다른 언어로 읽기
English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية | فارسی | Italiano | Polski | Nederlands | Türkçe | Українська | Tiếng Việt | Bahasa Indonesia | Svenska | Ελληνικά | Română | Čeština | Suomi | Dansk | Norsk | Magyar | ภาษาไทย | Oʻzbekcha | 繁體中文 | Filipino | עברית

에이전트 토큰 소비를 80% 절감하세요. Graphify Cloud는 에이전트를 관리하고, 코드 품질을 높게 유지하며, 형식 검증으로 정확성을 입증하는 상시 가동 메모리입니다. 무료 14일 체험 시작하기 →

AI 코딩 어시스턴트에서 /graphify를 입력하면 전체 프로젝트(코드, 문서, PDF, 이미지, 동영상)를 지식 그래프로 매핑하여, 파일을 grep으로 뒤지는 대신 쿼리할 수 있습니다.

코드 맵은 무료이며 완전히 로컬에서 동작합니다. 코드는 tree-sitter AST로 파싱됩니다: 결정적이며, LLM을 사용하지 않고, 어떤 것도 여러분의 머신을 벗어나지 않습니다. (문서, PDF, 이미지, 동영상은 시맨틱 패스에 어시스턴트의 모델 또는 설정된 API 키를 사용합니다.)
모든 엣지가 설명됩니다. 각 연결은 EXTRACTED(소스에 명시됨) 또는 INFERRED(graphify가 해석함)로 태그되므로, 직접 읽은 것과 추론된 것을 구분할 수 있습니다.
벡터 인덱스가 아닙니다. 임베딩도, 벡터 스토어도 없습니다: 탐색하는 실제 그래프입니다. 질문을 하거나, 두 대상 사이의 경로를 추적하거나, 하나의 개념을 설명할 수 있습니다.

참고

이것을 상시 가동하고 싶으신가요? Graphify Cloud는 전체 SDLC에 걸쳐 그래프를 라이브로 유지합니다: 모노레포 및 크로스 레포 지원, 형식 검증, SDLC 전반을 조망하는 코드 리뷰, 그리고 Sentry, Jira 등과의 커넥터로 인시던트와 티켓이 코드와 같은 그래프에 위치합니다. app.graphify.com 에서 무료 14일 체험을 시작하세요.

graphify로 매핑된 FastAPI 코드베이스. 모든 노드는 개념이고, 색상은 감지된 커뮤니티이며, 전체가 graph.html에서 클릭 가능합니다.

시작하기 (30초). Python 3.10+와 uv(또는 pipx)가 필요합니다:

uv tool install graphifyy # CLI 설치 (또는: pipx install graphifyy)
graphify install # 어시스턴트를 감지하고 스킬을 등록
그런 다음 AI 어시스턴트에서:

/graphify .

그게 전부입니다. 세 개의 파일을 얻습니다 :

graphify-out/
├── graph.html 아무 브라우저에서 열기: 노드 클릭, 필터, 검색
├── GRAPH_REPORT.md 하이라이트: 핵심 개념, 놀라운 연결, 추천 질문
└── graph.json 전체 그래프: 파일을 다시 읽지 않고 언제든 쿼리

영속 그래프에는 graph.schema_version이 포함되어 통합이
호환되지 않는 형식 변경을 감지할 수 있으며, 이를 생성한
Graphify 릴리스를 식별하는 graph.graphify_version도 포함됩니다.

한 번 설치로 어떤 어시스턴트, 어떤 OS에서도. Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot 등 20개 이상, macOS, Linux, Windows에서: 플랫폼 선택 .

실제 동작 보기

그래프가 구축되면 파일을 읽는 대신 쿼리합니다. 실제 출력, 위에 표시된 FastAPI 코드베이스에서 graphify를 실행한 결과:

$ 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는 두 대상이 어떻게 연결되는지 추적합니다.

기능
기본으로 얻는 것:

기능
얻는 것

God 노드
가장 많이 연결된 개념으로, 모든 것이 무엇을 통해 흐르는지 볼 수 있습니다

커뮤니티
그래프를 하위 시스템으로 분할(Leiden), LLM 없는 레이블 포함

크로스 파일 링크
calls / imports / inherits / mixes_in이 tree-sitter AST를 통해 약 40개 언어에 걸쳐 해석됨

쿼리, 경로, 설명
질문하기, 두 대상 사이의 경로 추적, 하나의 개념 설명, 모두 graph.json에 대해

근거 + 문서 참조
# NOTE: / # WHY: 주석과 ADR/RFC 인용이 코드에 연결된 일급 노드가 됨

코드 너머
문서, PDF, 이미지, 동영상/오디오가 모두 같은 그래프로 매핑됨

로컬 우선
코드는 tree-sitter로 로컬에서 파싱됨(LLM 없음, 어떤 것도 머신을 벗어나지 않음); 문서/미디어에 대한 시맨틱 패스만 백엔드를 호출하며, 설정한 경우에만 호출

팁

여러 레포나 모노레포에 걸쳐 실행하시나요? Graphify Cloud는 이를 지속적으로 수행하고 에이전트 토큰 소비를 80% 절감하며, 크로스 레포 링크, SDLC 전반의 코드 리뷰, 형식 검증, Sentry/Jira 커넥터를 제공합니다. 무료 14일 체험 시작하기 →

벤치마크: 0.497 recall@10, LLM 크레딧 0

벤치마크
지표
graphify
비교 대상

LOCOMO (n=300)
recall@10
0.497
mem0 0.048, supermemory 0.149

LOCOMO (n=300)
QA 정확도
45.3%
supermemory 49.7%, mem0 27.3%

LongMemEval-S (n=50)
QA 정확도
76%
dense RAG와 동률

ERPNext 크로스 툴 (n=6)
핵심 사실 커버리지
82.0%
grep/read 베이스라인 70.8%

그래프 구축
LLM 크레딧
0
대부분 시스템은 토큰당 과금

모든 시스템은 동일한 모델과 예산으로 동일한 하네스에서 실행되었으며, 두 번째 심사자에 대해 블라인드 검증된 심사자(90.6% 일치, Cohen's kappa 0.81)가 채점했습니다. 시스템별 전체 표, 코드 인텔리전스 결과, 재현 명령: BENCHMARKS.md .

문서
전체 가이드와 레퍼런스는 docs.graphify.com 에 있습니다:

빠른 시작 : 첫 그래프 구축
CLI 레퍼런스 : 모든 명령과 플래그
더 나은 그래프 질문하기 : 쿼리 패턴
설정 : 환경 변수와 튜닝
지원 입력 : 언어와 파일 유형
팀 워크플로와 PR 리뷰
문제 해결 및 동작 방식

사전 요구 사항

요구 사항
최소
확인
설치

Python
3.10+
python --version
python.org

uv (권장)
무관
uv --version
curl -LsSf https://astral.sh/uv/install.sh | sh

pipx (대안)
무관
pipx --version
pip install pipx

macOS 빠른 설치 (Homebrew):

brew install [email protected] uv
Windows 빠른 설치:

winget install astral - sh.uv
Ubuntu/Debian:

sudo apt install python3.12 python3-pip pipx
# 또는 uv 설치:
curl -LsSf https://astral.sh/uv/install.sh | sh

설치
중요

공식 패키지: PyPI 패키지는 graphifyy(더블 y)입니다. PyPI의 다른 graphify* 패키지는 제휴 관계가 없습니다. CLI 명령은 여전히 graphify입니다.

공식 소스 저장소는 Graphify-Labs/graphify 입니다.

두 명령 빠른 시작은 이 README 상단에 있습니다. 이 섹션은 설치 방법, 프로젝트 범위 설치, 모든 지원 플랫폼을 다룹니다.

설치 방법 (하나 선택):

uv tool install graphifyy # 권장, 격리된 환경 (이후 'graphify'를 찾을 수 없으면 실행: uv tool update-shell)
pipx install graphifyy # 대안
pip install graphifyy # PATH 설정이 필요할 수 있음, 아래 문제 해결 참조
그런 다음 graphify install을 한 번 실행합니다. 실행 중인 어시스턴트를 감지하고 스킬을 등록하므로 어시스턴트별 설정이 없습니다. AI 어시스턴트를 열고 /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 .

팁

command not found , Mac/Windows의 pip 문제, PowerShell 인용, uvx 사용, git-hook PATH 문제, 또는 strict 모드에 부딪히셨나요? 설치 및 문제 해결 을 참조하세요.

플랫폼 선택 (20개 이상 어시스턴트, 클릭하여 펼치기)

플랫폼
설치 명령

Claude Code (Linux/Mac)
graphify install

Claude Code (Windows)
graphify install (자동 감지) 또는 graphify install --platform windows

CodeBuddy
graphify install --platform codebuddy

Codex
graphify install --platform codex

OpenCode
graphify install --platform opencode

Kilo Code
graphify install --platform kilo

GitHub Copilot CLI
graphify install --platform copilot

VS Code Copilot Chat
graphify vscode install

Aider
graphify install --platform aider

OpenClaw
graphify install --platform claw

Factory Droid
graphify install --platform droid

Trae
graphify install --platform trae

Trae CN
graphify install --platform trae-cn

Gemini CLI
graphify install --platform gemini

Hermes
graphify install --platform hermes

Kimi Code
graphify install --platform kimi

Amp
graphify amp install

Agent Skills (크로스 프레임워크)
graphify install --platform agents (별칭 --platform skills )

Kiro IDE/CLI
graphify kiro install

Pi coding agent
graphify install --platform pi , 네이티브 가드용 graphify pi guard install

Cursor
graphify cursor install

Devin CLI
graphify devin install

Google Antigravity
graphify antigravity install

Google Antigravity (Windows)
graphify antigravity install (Windows에서 자동 감지)

Codex 사용자는 병렬 추출을 위해 ~/.codex/config.toml의 [features] 아래에 multi_agent = true도 필요합니다. CodeBuddy는 Claude Code와 동일한 Agent 도구와 PreToolUse 훅 메커니즘을 사용합니다. Factory Droid는 병렬 서브에이전트 디스패치에 Task 도구를 사용합니다. OpenClaw와 Aider는 순차 추출을 사용합니다(해당 플랫폼에서는 병렬 에이전트 지원이 아직 초기 단계). Trae는 병렬 서브에이전트 디스패치에 Agent 도구를 사용하며 PreToolUse 훅을 지원하지 않으므로 AGENTS.md가 상시 가동 메커니즘입니다.

--platform agents(별칭 --platform skills)는 일반 크로스 프레임워크 Agent-Skills 위치를 대상으로 합니다: 전역 설치는 스펙의 사용자 전역 ~/.agents/skills/(npx skills 및 스펙 준수 프레임워크가 읽음), 프로젝트(--project) 설치는 ./.agents/skills/입니다. 기본 graphify install은 설계상 단일 플랫폼(Claude Code)으로 유지됩니다: .agents/skills를 읽는 모든 프레임워크에서 스킬을 발견 가능하게 하려면 명명된 agents 플랫폼을 사용하세요.

Pi에는 PreToolUse 훅이 없으므로 graphify pi guard install은 네이티브 Pi 확장(Pi 자체의 pi install <package directory>를 통해)을 등록하여 Pi의 read, grep, find 및 검색 스타일 bash 호출 전에 설치된 graphify hook-guard를 실행합니다. 신선/오래된 그래프 결정과 GRAPHIFY_HOOK_STRICT=1 세션당 한 번의 인덱싱된 읽기 거부는 같은 정책에서 나오므로 Pi는 Claude Code의 훅 동작과 일치합니다; 안내는 <system-reminder source="graphify"> 스티어링 메시지로 도착합니다. Pi 0.58.4 이상이 필요합니다: 이전 버전은 스티어링 메시지가 병렬 도구 호출 배치의 나머지를 건너뛰게 했습니다. 패키지는 Graphify 설치 내부에 포함되므로 Graphify를 영속적으로 설치하고( uv tool install graphifyy 또는 pipx install graphifyy , uvx 아님), 설치 또는 업그레이드 후 Pi를 재시작하며, graphify pi guard uninstall로 제거합니다. 로컬 파일 대상만 검사됩니다; 훅은 프로젝트 외부의 절대 PATH 항목에 graphify가 필요하고, 2초, 256 KiB 입력/64 KiB 출력 호출로 제한되며, 실패 시 열림(fail open)입니다. 같은 패키지는 Oh My Pi에서도 로드됩니다: omp plugin install "$(graphify pi guard path)" . 등록된 경로에는 Python 버전과 venv가 포함되므로 둘 중 하나를 변경한 후 graphify pi guard install을 다시 실행하고, 이전 항목은 pi remove <old path>로 제거하세요.

Codex는 /graphify 대신 $graphify를 사용합니다.

선택적 추가 기능 (필요한 것만 설치)

추가 기능
추가되는 것
설치

pdf
PDF 추출
uv tool install "graphifyy[pdf]"

office
.docx 및 .xlsx 지원
uv tool install "graphifyy[office]"

google
Google Sheets 렌더링
uv tool install "graphifyy[google]"

video
동영상/오디오 전사 (faster-whisper + yt-dlp)
uv tool install "graphifyy[video]"

mcp
MCP stdio 서버
uv tool install "graphifyy[mcp]"

watch
파일 변경 시 자동 재빌드 ( graphify watch )
uv tool install "graphifyy[watch]"

neo4j
Neo4j 푸시 지원
uv tool install "graphifyy[neo4j]"

falkordb
FalkorDB 푸시 지원
uv tool install "graphifyy[f…