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

  • →An active Claude, OpenAI, Cursor, Gemini, OpenCode, or GitHub Copilot subscription
  • →macOS, Linux, or Windows

The installer handles everything else automatically — Python, Node.js, and your chosen AI tool are installed for you if missing.

macOS
1

Run the installer

One command installs everything. It will ask before installing any missing dependencies (Python, Node.js, Claude Code / Codex).

bash
1curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
2source ~/.zshrc
2

Run on your project

Open a new terminal, navigate to your project, and run:

bash
1dgc .                      # Claude Code
2dg .                       # Codex CLI
3graperoot . --cursor       # Cursor IDE
4graperoot . --gemini       # Gemini CLI
5graperoot . --opencode     # OpenCode
6graperoot . --copilot      # GitHub Copilot (VS Code)

Run this every time you start a project session. All six tools share the same dual-graph engine.

Linux
1

Run the installer

One command installs everything. It will ask before installing any missing dependencies (Python, Node.js, Claude Code / Codex).

bash
1curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
2source ~/.bashrc
2

Run on your project

Open a new terminal, navigate to your project, and run:

bash
1dgc .                      # Claude Code
2dg .                       # Codex CLI
3graperoot . --cursor       # Cursor IDE
4graperoot . --gemini       # Gemini CLI
5graperoot . --opencode     # OpenCode
6graperoot . --copilot      # GitHub Copilot (VS Code)

Run this every time you start a project session. All six tools share the same dual-graph engine.

Windows
1

Run the installer (PowerShell)

One command installs everything. It will ask before installing any missing dependencies (Python, Node.js, Claude Code / Codex) via winget.

powershell
1Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
2irm https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.ps1 | iex
2

Run on your project

Open a new PowerShell window, navigate to your project, and run:

powershell
1dgc .                    # Claude Code
2dg .                     # Codex
3graperoot . --cursor     # Cursor IDE
4graperoot . --gemini     # Gemini CLI

Run this every time you start a project session. All six tools share the same dual-graph engine.

Per IDE

Set up with your IDE

One local MCP server. Each IDE just needs to know where to find it. Click any tool below to see exactly what to run — and run it every time you start a session.

!

Keep the terminal running

The launch command starts the local MCP server and stays attached. If you close the terminal window, the server stops — and your IDE will lose context. Leave it open for the whole session. To stop, press Ctrl + C in that terminal.

Claude CodeCLI agent

Run in any terminal — VS Code, JetBrains, plain shell. No IDE config needed.

terminal
$ dgc .
  1. 1Open a terminal in your project folder.
  2. 2Run dgc . — Claude Code launches with the dual-graph MCP server.
  3. 3That's it. Hooks fire on session start to prime context.
Codex CLICLI agent

Same idea as Claude Code — runs anywhere there's a terminal.

terminal
$ dg .
  1. 1cd into your project.
  2. 2Run dg . — Codex starts with the MCP server attached.
  3. 3Use Codex normally; the graph context is already there.
Gemini CLICLI agent

Terminal-based; works from any IDE's integrated shell.

terminal
$ graperoot . --gemini
  1. 1From your project folder, run graperoot . --gemini.
  2. 2Gemini CLI opens with the MCP server connected.
  3. 3No IDE config file needed.
CursorAI-native IDE

Writes .cursor/mcp.json once, then Cursor finds the server every time.

terminal
$ graperoot . --cursor
  1. 1Run graperoot . --cursor in your project — Cursor opens automatically.
  2. 2Open Cursor Settings → Tools & Integrations → MCP.
  3. 3Toggle dual-graph on. The config file is already written.
GitHub Copilot (VS Code)AI-native IDE

Writes .vscode/mcp.json — picked up by Copilot Chat in Agent mode.

terminal
$ graperoot . --copilot
  1. 1Run graperoot . --copilot — VS Code opens with the server running.
  2. 2Open the Copilot Chat panel and switch to Agent mode.
  3. 3Enable dual-graph in the MCP servers list.
OpenCodeAI-native IDE

Writes opencode.json. No extra in-app step — shows up as '1 MCP'.

terminal
$ graperoot . --opencode
  1. 1Run graperoot . --opencode in your project.
  2. 2OpenCode launches with the dual-graph MCP server pre-registered.
  3. 3Confirm the '1 MCP' badge in the OpenCode status bar.

Got questions?

All FAQs live in one place now.

Install issues, privacy, billing, updates — answered on the docs page.

Browse FAQs