Platform Setup

Fresh

Supported Platforms

Graphify ships with native integrations for the following AI coding assistants:

Platform	Install Command	Hook Type
Claude Code	graphify claude install	CLAUDE.md + PreToolUse hook
Codex / OpenCode	graphify codex install	AGENTS.md + hook
Cursor	graphify cursor install	.cursor/rules/
GitHub Copilot CLI	graphify install --platform copilot	—
VS Code Copilot Chat	graphify vscode install	—
Aider	graphify install --platform aider	—
Gemini CLI	graphify gemini install	GEMINI.md + hook
OpenClaw	Manual (see below)	SKILL.md
Factory Droid	Manual (see below)	—
Trae	Manual (see below)	—
Google Antigravity	Manual (see below)	—

Claude Code — Detailed Setup

What Gets Installed

graphify claude install

This installs two components:

1. CLAUDE.md directive — Tells Claude to check graphify-out/graph.json and GRAPH_REPORT.md before answering architecture questions
2. PreToolUse hook — Fires automatically before every file-search tool call, injecting relevant graph context

How It Works

sequenceDiagram
    participant User
    participant Claude Code
    participant PreToolUse Hook
    participant graph.json
    participant Codebase

    User->>Claude Code: "How does auth work?"
    Claude Code->>PreToolUse Hook: Fires before file search
    PreToolUse Hook->>graph.json: Query relevant nodes
    graph.json-->>PreToolUse Hook: Auth-related subgraph
    PreToolUse Hook-->>Claude Code: Graph context injected
    Claude Code->>Codebase: File search (with graph as guide)
    Codebase-->>Claude Code: Relevant files
    Claude Code-->>User: Accurate, context-aware answer

Uninstall

graphify claude uninstall

Codex / OpenCode Setup

graphify codex install

Writes to AGENTS.md and installs a compatible hook. Works with OpenCode as well.

Cursor Setup

graphify cursor install

Writes rules to .cursor/rules/graphify.mdc. Cursor reads this directory automatically.

Gemini CLI Setup

graphify gemini install

Writes to GEMINI.md and installs a PreToolUse hook equivalent for Gemini's tool-calling architecture.

Manual Setup (OpenClaw, Factory Droid, Trae, Antigravity)

For assistants without native installer support, manual setup takes three steps:

Step 1: Download the Skill File

curl -o ~/.claude/skills/graphify/SKILL.md \
  https://raw.githubusercontent.com/safishamsi/graphify/main/SKILL.md

Step 2: Register in Your Assistant's Config

Add to your assistant's main config file:

- **graphify** (`~/.claude/skills/graphify/SKILL.md`) - any input to knowledge graph

Step 3: Point at Your Graph

After running /graphify ., the graph is at ./graphify-out/graph.json. Your assistant should reference this path in queries.

Always-On vs On-Demand

Mode	When to Use
Always-On (with install)	Long-running projects where graph stays current
On-Demand (manual query)	One-off analysis or when working across multiple repos

Always-On Benefit

The Claude Code integration consults the graph before every file-search tool call — not after. This means Claude uses the graph to guide which files to read, not just to supplement what it found.