codegraph/site/src/content/docs/getting-started/installation.md at b9dc4a0fa51dd5dd556a9788ed763ac7f8a931c3

Files

T

b9dc4a0fa5 docs: add Kiro to README + site docs (and fill in Gemini/Antigravity gaps) (#474 )

PR #473 added the Kiro installer target but missed updating the README
and site documentation. This sweeps both:

- README: hero H3, badges row, installer subtitle, auto-detect list,
  restart line, Supported Agents bullet list, footer tagline.
- site/: integrations.md supported-agents list, installation.md
  auto-detect + restart lines, quickstart.md installer subtitle,
  introduction.md tagline, guides/indexing.md auto-sync paragraph,
  pages/index.astro MCP feature card.

The Supported Agents section in README and integrations.md were also
already stale from PR #399 — they didn't list Gemini CLI or Antigravity
IDE. Fixed those alongside.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-26 18:14:18 -05:00

2.7 KiB

Raw Blame History

title, description

title	description
Installation	Install CodeGraph and configure your AI coding agents.

1. Run the installer

npx @colbymchenry/codegraph

The installer will:

Ask which agent(s) to configure — auto-detecting installed ones from Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity IDE, and Kiro.
Prompt to install codegraph on your PATH (so agents can launch the MCP server).
Ask whether configs apply to all your projects or just this one.
Write each chosen agent's MCP server config plus an instructions file (e.g. CLAUDE.md, .cursor/rules/codegraph.mdc, ~/.codex/AGENTS.md).
Set up auto-allow permissions when Claude Code is one of the targets.
Initialize your current project (local installs only).

Non-interactive (scripting / CI)

codegraph install --yes                              # auto-detect agents, install global
codegraph install --target=cursor,claude --yes       # explicit target list
codegraph install --target=auto --location=local     # detected agents, project-local
codegraph install --print-config codex               # print snippet, no file writes

Flag	Values	Default
`--target`	`auto`, `all`, `none`, or csv (`claude,cursor,…`)	prompt
`--location`	`global`, `local`	prompt
`--yes`	(boolean)	prompt every step
`--no-permissions`	(boolean) skip Claude auto-allow list	permissions on
`--print-config <id>`	dump snippet for one agent and exit	—

2. Restart your agent

Restart your agent (Claude Code / Cursor / Codex CLI / opencode / Hermes Agent / Gemini CLI / Antigravity IDE / Kiro) for the MCP server to load.

3. Initialize projects

cd your-project
codegraph init -i

This builds the per-project knowledge graph index and wires up any project-local agent surfaces, so a single global codegraph install works in every project you open.

Supported platforms

Every release ships a self-contained build (bundled Node runtime — nothing to compile) for all three desktop OSes, on both x64 and arm64:

Platform	Architectures	Install
Windows	x64, arm64	PowerShell installer or npm
macOS	x64, arm64	shell installer or npm
Linux	x64, arm64	shell installer or npm

Uninstall

Changed your mind? One command removes CodeGraph from every agent it configured:

codegraph uninstall

This reverses the installer — stripping CodeGraph's MCP server config, instructions, and permissions from each configured agent. Your project indexes (.codegraph/) are left untouched; remove those per-project with codegraph uninit. Use --target to remove from specific agents, or --yes to run non-interactively.

2.7 KiB Raw Blame History