graph-it-live（实时绘制图表）

Graph-It-Live

AI-first dependency intelligence CLI for codebase analysis. Analyze dependencies, call graphs, symbols, impact, and architecture from any agent-compatible IDE or CLI.

When to Use

• Analyze file dependencies and imports
• Trace function execution across files
• Find all callers of a symbol (function, class, method)
• Detect breaking changes before refactoring
• Find unused exports / dead code
• Generate a codemap (structural overview) of any file
• Analyze intra-file call hierarchy and logic flow
• Crawl the full dependency tree from an entry point
• Find all files that import a given file (reverse lookup)
• Detect circular dependencies / cycles
• Check impact of changing a function signature
• Get a workspace architecture overview

Quick Start — Installation

Requires Node.js v20+.

# Install globally
npm install -g @magic5644/graph-it-live

# Or run without installing
npx @magic5644/graph-it-live <command>

After global install, graph-it is available on PATH. Verify:

graph-it --version

Supported Languages

TypeScript, JavaScript, Python, Rust, C#, Go, Java, Vue, Svelte, GraphQL.

CLI Commands Reference

Index the Workspace

Always run scan first to build the dependency index. All other commands depend on it.

graph-it scan

Re-run after significant file changes to refresh the index.

Workspace Overview

graph-it summary                   # Full workspace overview
graph-it summary src/api.ts        # Per-file codemap

The per-file codemap returns: exports, internals, dependencies, dependents, call flow, cycles.

Trace Execution Flow

Trace the complete call chain starting from a function:

graph-it trace src/index.ts#main
graph-it trace src/auth.ts#validateToken

Format: <filePath>#<functionName>. Use absolute or relative paths.

Analyze File Logic

Show the intra-file call hierarchy — which functions call which, in what order:

graph-it explain src/server.ts

Returns entry points, call tree, and internal cycles.

Dependency Graph

Crawl the full dependency tree from an entry file:

graph-it path src/index.ts

Shows all transitive imports and detects circular dependencies.

Find Unused Exports

Detect dead code — exported symbols that no other file imports:

graph-it check src/api.ts

Output Formats

All commands support --format:

graph-it summary src/api.ts --format toon
graph-it path src/index.ts --format mermaid
graph-it trace src/index.ts#main --format json

Prefer --format toon when consuming output programmatically — it saves 30-60% tokens.

Advanced: MCP Tool Invocation

The CLI can invoke any of the 21 MCP tools directly:

graph-it tool --list                    # List all available tools
graph-it tool <tool_name> [--params]    # Invoke a specific tool

Available MCP Tools

Tool Invocation Examples

# Analyze a single file's dependencies
graph-it tool analyze_dependencies --filePath=/abs/path/to/file.ts

# Find all files importing a specific file
graph-it tool find_referencing_files --filePath=/abs/path/to/file.ts

# Get all callers of a symbol
graph-it tool get_symbol_callers --filePath=/abs/path/to/file.ts --symbolName=myFunction

# Full impact analysis
graph-it tool get_impact_analysis --filePath=/abs/path/to/file.ts --symbolName=calculateTotal

# Detect breaking changes
graph-it tool analyze_breaking_changes --filePath=/abs/path/to/file.ts --symbolName=processData

# Generate codemap
graph-it tool generate_codemap --filePath=/abs/path/to/file.ts

# Query call graph (BFS)
graph-it tool query_call_graph --symbolName=handleRequest --direction=callers --maxDepth=3

Important: Tool --filePath arguments require absolute paths.

MCP Server Mode

Launch as an MCP server for AI client integration (no VS Code required):

graph-it serve

MCP Client Configuration

VS Code / Cursor (.vscode/mcp.json or .cursor/mcp.json):

{
  "servers": {
    "graph-it-live": {
      "type": "stdio",
      "command": "graph-it",
      "args": ["serve"],
      "env": { "WORKSPACE_ROOT": "${workspaceFolder}" }
    }
  }
}

Claude Desktop (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "graph-it-live": {
      "command": "graph-it",
      "args": ["serve"],
      "env": { "WORKSPACE_ROOT": "/path/to/project" }
    }
  }
}

Claude Code CLI:

claude mcp add graph-it -- graph-it serve

Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "graph-it-live": {
      "command": "graph-it",
      "args": ["serve"],
      "env": { "WORKSPACE_ROOT": "${workspaceFolder}" }
    }
  }
}

VS Code Extension (Alternative)

Graph-It-Live is also a VS Code extension with native LM Tools for Copilot Agent mode (no MCP setup needed).

Install from Marketplace: search "Graph-It-Live" in Extensions (Ctrl+Shift+X).

Enable MCP server in extension: set graph-it-live.enableMcpServer to true in VS Code settings.

Common Workflows

"What breaks if I change this function?"

graph-it scan
graph-it tool get_impact_analysis --filePath=/abs/path/file.ts --symbolName=myFunction

"Give me an overview of this module"

graph-it summary src/auth/index.ts --format toon

"Find dead code in my project"

graph-it check src/utils.ts
graph-it tool find_unused_symbols --filePath=/abs/path/utils.ts

"Trace the execution from main()"

graph-it trace src/index.ts#main --format mermaid

"Are there circular dependencies?"

graph-it path src/index.ts

Cycles are auto-detected and reported.

"Who calls this function across the project?"

graph-it tool get_symbol_callers --filePath=/abs/path/file.ts --symbolName=formatDate

Update

graph-it update