HomeSetup Guide

Setup Guide

Install Dual-Graph globally once, then run it on any project in seconds. Everything runs 100% locally — no account, no API key, no cloud.

Prerequisites

  • →Claude Code (Anthropic) or Codex CLI (OpenAI) installed
  • →An active Claude or ChatGPT Pro/Plus subscription
  • →macOS, Linux, or Windows
macOS / Linux
1

Install Homebrew (if not already installed)

Homebrew is a package manager for macOS and Linux.

bash
1/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2

Configure Homebrew in your shell

bash
1echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
2eval "$(/opt/homebrew/bin/brew shellenv)"
3

Install Python 3.11

bash
1brew install python@3.11
4

Install Dual-Graph

bash
1brew tap kunal12203/tap
2brew install dual-graph
3dual-graph-install
5

Reload your shell

bash
1source ~/.zshrc
Windows
1

Fresh setup commands for a new Windows laptop

powershell
1# 1) Allow scripts (once)
2Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
3
4# 2) Install Scoop
5irm get.scoop.sh | iex
6
7# 3) Install runtime deps (open NEW terminal after this)
8scoop install python311 nodejs
9
10# 4) Install Claude Code
11npm install -g @anthropic-ai/claude-code
12
13# 5) Install dual-graph from bucket
14scoop bucket add dual-graph https://github.com/kunal12203/scoop-dual-graph
15scoop update
16scoop install dual-graph
Per Project — run after global install

After the global install, run one of the commands below inside your project directory. Dual-Graph will scan your codebase, build the graphs, and start the MCP server automatically.

bash
1dg  /path/to/project   # Codex CLI (OpenAI / ChatGPT)
2dgc /path/to/project   # Claude Code (Anthropic)

That's it!

Your AI coding assistant will automatically connect to the local MCP server and receive enriched context for every query.

Windows FAQ

C) First-run validation on new laptop

Run `where.exe dgc`, `where.exe claude`, and `claude --version`. Then start `dgc "C:\path\to\your\project"` and run `claude mcp list` in a second terminal.

Why do I still get old dual-graph behavior after reinstall?

Run section A fully to remove project-local artifacts, user install folders, and Scoop shims before reinstalling.

Do I need to open a new terminal during setup?

Yes. After `scoop install python311 nodejs`, open a new PowerShell terminal before continuing with the remaining commands.