safishamsi/graphify

AI 코딩 어시스턴트 스킬입니다 (Claude Code, Codex, OpenCode, Cursor, Gemini CLI 등). 모든 폴더의 코드, SQL 스키마, R 스크립트, 셸 스크립트, 문서, PDF, 이미지, 비디오를 쿼리 가능한 지식 그래프로 변환합니다. 앱 코드 + 데이터베이스 스키마 + 인프라를 하나의 그래프로 통합합니다.

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

Claude Code, Codex, OpenCode, Kilo Code, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, Amp, OpenClaw, Factory Droid, Trae, Hermes, Kimi Code, Kiro, Pi, Devin CLI, Google Antigravity에서 작동합니다.

/graphify.

세 개의 파일이 생성됩니다:

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

Mermaid 호출 흐름 다이어그램이 포함된 읽기 쉬운 아키텍처 페이지를 보려면 다음을 실행하세요:

graphify export callflow-html

사전 요구사항

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입니다.

1단계 — 패키지 설치:

# 권장 (격리된 환경; 이후 'graphify'를 찾을 수 없으면 실행: uv tool update-shell):
uv tool install graphifyy

# 대안:
pipx install graphifyy
pip install graphifyy  # PATH 설정 필요할 수 있음 — 아래 참고

2단계 — AI 어시스턴트에 스킬 등록:

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).

PowerShell 참고: /graphify. 대신 graphify.를 사용하세요 — PowerShell에서 슬래시는 경로 구분자입니다.

graphify: command not found? uv tool install / pipx install은 graphify 명령어를 해당 도구 bin 디렉터리(~/.local/bin)에 넣습니다. 설치 직후 셸에서 찾을 수 없는 경우 (새로운 macOS + zsh 설정에서 흔함) 해당 디렉터리가 PATH에 없기 때문입니다: uv tool update-shell (또는 pipx ensurepath)을 실행한 후 새 터미널을 여세요. 일반 pip의 경우 Linux에서는 ~/.local/bin, Mac에서는 ~/Library/Python/3.x/bin을 PATH에 추가하거나 python -m graphify를 실행하세요.

설치 대신 uvx / uv tool run으로 실행? 패키지 이름을 지정하세요 (명령어 아님): uvx --from graphifyy graphify install. 일반 uvx graphify …는 실패합니다 (No solution found … no versions of graphify). uv tool run은 첫 번째 단어를 패키지로 읽고 패키지는 graphifyy이며 graphify 명령어는 그 안에 있기 때문입니다.

Mac/Windows에서 pip install은 피하세요 가능하면. 스킬은 런타임에 graphify-out/.graphify_python에서 Python을 확인합니다. 이 경로가 pip가 패키지를 설치한 환경과 다르면 ModuleNotFoundError: No module named 'graphify' 오류가 발생합니다. uv tool install과 pipx install은 패키지를 자체 환경에 격리하여 이 문제를 완전히 피합니다.

Git 훅과 uv tool / pipx: graphify hook install은 설치 시 현재 인터프리터 경로를 훅 스크립트에 직접 포함하므로 GUI git 클라이언트 및 CI 실행기에서도 post-commit 훅이 올바르게 실행됩니다 (~/.local/bin이 PATH에 없더라도). graphify를 재설치하거나 업그레이드하는 경우 graphify hook install을 다시 실행하여 포함된 경로를 새로 고치세요.

플랫폼 선택

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 플랫폼을 사용하세요.

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

선택적 확장 기능

필요한 것만 설치하세요: