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 or OpenAI subscription
  • →macOS, Linux, or Windows

The installer handles everything else automatically — Python, Node.js, and Claude Code / Codex CLI 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

Run this every time you start a project session with Claude Code or Codex.

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

Run this every time you start a project session with Claude Code or Codex.

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

Run this every time you start a project session with Claude Code or Codex.

Don't forget: run dgc / dg before every session

The installer only needs to run once. But dgc . (Claude Code) or dg . (Codex) needs to run every time you open a project. It's what connects GrapeRoot to your AI, builds the code map, and starts token tracking.

$ cd /path/to/your/project
$ dgc .# Claude Code
$ dg .# Codex

FAQ

Do I need to install Python or Node.js first?

No. The installer detects missing dependencies and offers to install them automatically. Just say Y when prompted.

How do I get updates?

Just run `dgc .` or `dg .` as usual. It auto-updates to the latest version every time you launch — no manual update needed.

Windows: Do I need to open a new terminal during setup?

Only if the installer needs to install Python or Node.js. It will tell you clearly when a new terminal is needed, then you just re-run the same command.

How do I validate my install?

Run `where.exe dgc` (Windows) or `which dgc` (macOS/Linux), then `claude --version` or `codex --version`. Start with `dgc /path/to/project` (Claude Code) or `dg /path/to/project` (Codex).

Windows: "Python was not found" during install

Windows ships fake python.exe stubs that open the Microsoft Store instead of running Python. Go to Settings > Apps > Advanced app settings > App execution aliases and disable the Python aliases. Then re-run the installer — it will install real Python for you via winget.

"MCP registration failed" on macOS/Linux

This means Claude Code or Codex CLI is not installed or not on your PATH. GrapeRoot v3.8.45+ will auto-install missing dependencies. Re-run the one-line installer, then open a new terminal and run dgc/dg again.

"Claude exited with code 1" or "codex exited with code 1"

This usually means the CLI is not authenticated or your subscription has expired. Run `claude` or `codex` by itself first to log in, then try dgc/dg again. If that doesn't help, re-run the installer to get the latest version.

What's the difference between dgc and dg?

`dgc` launches GrapeRoot with Claude Code (Anthropic). `dg` launches GrapeRoot with Codex (OpenAI). Both use the same dual-graph engine — just pick the AI you prefer.

"Cannot find path" or "Illegal characters in path"

Make sure the project path you pass to dgc/dg actually exists and doesn't contain special characters. Use quotes around paths with spaces: dgc "C:\My Projects\app"

Something else went wrong?

Run `dgc .` or `dg .` again — it auto-updates to the latest version which may fix the issue. If it persists, re-run the installer to update everything, or join our Discord for help: https://discord.gg/rxgVVgCh