图形思维

Install

`graphmind setup` (once, global)

Configures your machine so all AI tools can use graphmind: 1. Claude Code hooks (rewrites grep/find, injects session context, pre-fetches on prompts) 2. Claude Code skill (3-layer rule: graph → memory → raw files) 3. Claude Desktop MCP (~/Library/Application Support/Claude/claude_desktop_config.json) 4. Claude Code MCP (~/.claude/settings.json)

Manual setup (if you prefer granular control)

<details> <summary>Click to expand</summary>

MCP server for Claude Code

claude mcp add graphmind -- graphmind mcp

Or manually in ~/.claude/settings.json:

{
  "mcpServers": {
    "graphmind": {
      "command": "graphmind",
      "args": ["mcp"]
    }
  }
}

MCP server for Claude Desktop

Claude Desktop does not inherit your shell PATH. Use the full path:

{
  "mcpServers": {
    "graphmind": {
      "command": "/opt/homebrew/bin/graphmind",
      "args": ["mcp"]
    }
  }
}

Config file location: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json

Tip: Run which graphmind to find the correct path on your system.

Per-project .mcp.json (optional)

{
  "mcpServers": {
    "graphmind": {
      "command": "graphmind",
      "args": ["mcp"]
    }
  }
}

Picked up automatically by Claude Code when you open the project.

Claude Code search hook

graphmind install hook-claude

Registers hooks in ~/.claude/settings.json for: - PreToolUse — rewrites grep/find/rg to graphmind search, provides graph results for Grep/Glob/LS tools - SessionStart — loads project context (stats, structure) at session start - UserPromptSubmit — pre-fetches relevant graph context based on the user's prompt - PostToolUse — enriches results with graph-aware suggestions

Built-in intelligence: - Exhaustive search bypass — detects "find all occurrences", grep -c, pipes to wc/sort and lets them through - Cache deduplication — identical searches within 5 minutes are skipped (0 tokens cost) - Pattern extraction — extracts meaningful search terms from grep, find, fd, rg commands and Agent prompts

Claude Code skill

graphmind install skill

CLAUDE.md sync

graphmind sync                # updates CLAUDE.md in current project
graphmind sync --all          # updates CLAUDE.md for all registered projects

Git hooks

graphmind install hook-git

</details>

Setup & Init

graphmind setup                   # global one-time (hooks, MCP, skill)
graphmind init [path]             # per-project (register, git hooks, build)
graphmind init --skip-build       # per-project without building

Build

graphmind build [slug]        # incremental build
graphmind build --all         # all projects
graphmind build --full        # force full rebuild
graphmind build --watch       # watch mode (debounced 2s)
graphmind clean [slug]        # remove graph cache (forces full rebuild)
graphmind clean --all         # clean all projects

Install / Uninstall

graphmind install hook-claude     # Claude Code search hook
graphmind install hook-git        # git hooks (post-commit + pre-push)
graphmind install skill           # Claude Code skill
graphmind uninstall hook-claude   # remove Claude Code hook
graphmind uninstall hook-git      # remove git hooks
graphmind sync [slug]             # inject graph context into CLAUDE.md
graphmind sync --all              # update CLAUDE.md for all projects

Setup

git clone https://github.com/aouicher/graphmind
cd graphmind
cargo build --release -p graphmind-cli
cargo clippy --workspace -- -D warnings
cargo test --workspace

Quick Start

graphmind setup          # once — configures Claude Code, Claude Desktop, hooks, skill
cd ~/projects/myapp
graphmind init           # per project — registers, installs git hooks, builds graph

That's it. Claude Code and Claude Desktop will use graphmind automatically.

CLI — shell script (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/aouicher/graphmind/main/scripts/install.sh | bash

Then run graphmind setup once to configure Claude Code, hooks, and skill.

CLI — Linux (direct download)

curl -fsSL https://github.com/aouicher/graphmind/releases/latest/download/graphmind-cli-linux-x64 -o ~/.local/bin/graphmind
chmod +x ~/.local/bin/graphmind

MCP Tools Reference

graphmind exposes 25 tools via MCP (Model Context Protocol):