Install Guild

Give your existing coding agent memory, skills, approvals, and connector tools over MCP.

Find your setup

DAC distributes Guild through your Codex workspace and your Claude team, so most people install little or nothing. Pick the row that describes you.

Codex or ChatGPT on DAC Enterprise
Nothing to install
DAC Guild is managed for your workspace, so it is already there. Start a task and ask Guild for something. If a prompt to connect appears, complete it once. You do not need the Guild CLI.
Claude Code on the DAC Claude team
Install the Guild CLI
The plugin is pushed to you as a team-managed plugin and updates itself — do not install it by hand. The one local prerequisite is the Guild CLI. This command installs the CLI only; ignore the plugin-install suggestions it prints when it finishes.
Windows (PowerShell)
iwr https://guild.dacgroup.com/api/v1/install.ps1 -UseBasicParsing | iex
macOS or Linux
curl -fsSL https://guild.dacgroup.com/api/v1/install.sh | sh
On Windows, the plugin's shell hooks also need Git Bash, and its session-end hook needs a public `node` on PATH. Claude Desktop installs neither for you. If either is missing, the setup check says so at the start of a session.
Everything else
Use the detail below
Another harness (Cursor, VS Code, Antigravity, opencode), API-key authentication, a personal rather than DAC Enterprise or Team account, or a remote or scripted install. These are rare. Open the advanced sections below, or hand the whole playbook to an agent and let it work out the lane.

Whichever lane you are in, connect Microsoft 365 once at Settings → Connections to unlock email, calendar, Teams, and files.

After you connect: make Guild yours

Name your agent, add a portrait, choose its voice, and try a Quickpages project update from the onboarding guide.

Open onboarding guide

Need help or use another coding agent?Give an agent the universal setup request when your managed plugin is unavailable or you need a remote, scripted, or another-harness setup. The agent detects the lane so you do not have to.

Tell whatever coding agent you already have open:

Go to https://guild.dacgroup.com/install/agent and set up Guild for me. Detect this harness and operating system, use the recommended plugin when supported or the hosted MCP fallback, connect and prove Guild tools first, show me what works now, then explore Guild skills from the remote catalog.

Guild currently supports DAC colleagues using their DAC Microsoft account. Share https://guild.dacgroup.com/install within DAC, or give an agent the raw playbook at https://guild.dacgroup.com/install/agent.

Managed distribution first, advanced fallback when needed

Codex gets Guild from the DAC ChatGPT Enterprise workspace and Claude Code from the DAC Claude team plugin. Both channels install and update themselves, so a managed plugin should never be re-staged by hand. Remote, scripted, and other supported harness setups can use the agent-guided playbook or the manual section below. Guild's one-time CLI installer downloads the published binary, verifies its SHA-256 checksum, installs only for the current user, and carries no credentials. It installs the CLI alone and never installs or replaces a harness plugin. It currently supports Windows x64, Linux x64, and macOS Apple silicon. Later updates are checksum-verified and restore the previous binary if validation fails.

Review the technical playbookOptional detail for reviewers and agents: exact steps, harness setup paths, and local compatibility notes.

Agent playbook

The agent follows these steps; you do not need to execute them yourself.

1
Identify your harness
Work out which coding agent / harness and operating system you are running in (Claude Code, Codex, Cursor, VS Code, ChatGPT, Antigravity, opencode, …). Detect whether the harness exposes its plugin command before choosing plugin or Tools-only mode.
2
Choose one installation lane
Claude Code and Codex normally arrive managed: Codex through the DAC ChatGPT Enterprise workspace (nothing to install) and Claude Code through the DAC Claude team plugin (install the Guild CLI only). Never re-stage a managed plugin or duplicate its MCP registration. Codex desktop uses the DAC workspace plugin when it is available; its advanced CLI fallback stages the Codex plugin from the checksum-verified Guild binary's bundled payload and never clones the private Guild repository. Cursor uses its shipped adapter. Other harnesses register the hosted HTTP endpoint in Tools-only mode. Local Guild stdio is retired and unsupported.
3
Authenticate the applicable Guild tools
Use the harness-managed MCP browser OAuth flow for hosted Guild tools. opencode is the exception: it uses GUILD_MCP_TOKEN with oauth=false after a Guild CLI login preflight. After hosted Guild MCP browser consent succeeds, follow get_cli_repair_plan(target="claude_code") and its lifecycle_claim conditions. Only when the plan and local doctor identify a missing or invalid lifecycle credential, call provision_lifecycle_claim(target="claude_code") through the authenticated Guild MCP connection, then run the returned `guild lifecycle claim <claim>` command on this machine. The CLI redeems the single-use claim and writes the trace-only credential without printing the durable credential. Preserve a working credential. Use `guild login --no-browser` only if MCP provisioning is unavailable; skipping both leaves lifecycle tracing degraded, not complete. Cursor uses a separate Guild CLI credential for lifecycle tracing. Codex uses no Guild lifecycle credential; its CLI fallback only carries the plugin payload. Show any interactive authorization page to the user immediately, keep the login command alive, and check its terminal result. Never leave authorization in a hidden browser tab while claiming login is still waiting. Never request broader sandbox or filesystem access for setup. If a required local plugin or lifecycle layer is unavailable, continue in hosted MCP Tools-only mode so core tools still work, but report the missing local capability as degraded rather than calling setup complete.
4
Prove Guild tools and show value
Call named Guild tools directly when advertised. In the default code profile, dispatch get_setup_instructions and get_connection_readiness through call_tool(name="<tool>", arguments={...}). Use target=<detected target>, follow the connected-user contract, confirm identity and available systems without dumping scopes or tool inventories, then offer up to three safe prompts matched to what is connected. For Codex, never launch a nested `codex exec` as a substitute for readiness. First test Guild directly in the current task. Check `codex plugin list`, `codex mcp list`, and a Guild skill lookup. If the current task lacks the newly installed tools or guidance, explain that it may retain its initial plugin context and suggest the user start a new Codex task. Provide a copyable handoff containing the user's actual request and verified setup state, without credentials; create a task only if the user explicitly asks. Restart the app only if that new task still does not load the installed plugin or tools. Use target="generic" for an unrecognized MCP client.
5
Explore Guild skills
For normal work, call find_skill(query="<the user request>", load_best_match=true) or get_skill for an advertised slug; server-side skills are current without local sync. Plugin-managed skills update through their plugin owner. A selected skill with requires_install uses its returned install args with install_artifact. Only when the user explicitly requests a bulk local export, invoke install_recommended_artifacts(target=<detected target>, response_mode="full"), directly when advertised or through call_tool in the default code profile. Apply every write_plan entry where write=true, read and parse the JSON at the returned inventory_path, then pass that post-write inventory to first_run_smoke through the same profile-aware dispatch. Report Guild tools, plugin/adapter, lifecycle status, and local artifact export separately. ChatGPT has no local artifact sync.
6
Make Guild yours and try Quickpages
Offer optional personalization at https://guild.dacgroup.com/my-agent/settings#onboarding: name the agent, generate or upload a photo, choose its personality, and edit personal preferences. Users can revisit Settings or ask for a change anytime, such as 'Always show screenshots inline in monday.com task updates.' Follow get_setup_instructions for the current context read, merge, save, and readback workflow; preserve unrelated preferences and report pending review honestly. Showcase Quickpages with 'Draft a Quickpage project update with an executive summary, screenshots, and next steps.' Discover the current tools or skill, preview first, and confirm the audience before publishing; a demo is not publication consent and DAC access remains the default. This optional personalization path is separate from the governed priorities interview.
7
Offer governed personalization
After the user has seen what works now, call find_skill(query="onboarding interview", load_best_match=true) and follow loaded_skill.skill_md. If get_skill is needed and is not advertised directly, dispatch it through call_tool(name="get_skill", arguments={"slug":"onboarding-interview"}). Offer the governed skill's brief, skippable flow exactly; do not substitute or maintain a second hard-coded questionnaire.

Setup path by harness

Every path uses the hosted endpoint https://mcp.guild.dacgroup.com/mcp.

Claude Code

The DAC Guild plugin is pushed to Claude Code as a team-managed plugin, so it installs and updates itself. Treat it as owned by that channel: do not run `guild plugin install claude_code` over it, add a second Guild MCP registration, or write your own hooks.json. The remaining step is the public Guild CLI, which the plugin needs locally. This installs the CLI only. Windows x64 PowerShell: iwr https://guild.dacgroup.com/api/v1/install.ps1 -UseBasicParsing | iex. macOS Apple silicon or Linux x64: curl -fsSL https://guild.dacgroup.com/api/v1/install.sh | sh.
Restart Claude Code once after a fresh CLI install so the hook process picks up the new PATH. Complete the hosted Guild MCP consent in a visible browser and keep the flow alive until it finishes. Then After hosted Guild MCP browser consent succeeds, follow get_cli_repair_plan(target="claude_code") and its lifecycle_claim conditions. Only when the plan and local doctor identify a missing or invalid lifecycle credential, call provision_lifecycle_claim(target="claude_code") through the authenticated Guild MCP connection, then run the returned `guild lifecycle claim <claim>` command on this machine. The CLI redeems the single-use claim and writes the trace-only credential without printing the durable credential. Preserve a working credential. Use `guild login --no-browser` only if MCP provisioning is unavailable; skipping both leaves lifecycle tracing degraded, not complete. If local installation is blocked, continue temporarily in degraded Tools-only mode with claude mcp add --transport http --scope user guild https://mcp.guild.dacgroup.com/mcp and report that lifecycle tracing is not active.
Rare unmanaged case only — a personal Claude account, API-key auth, or any install where Claude lists no Guild plugin at all: stage it yourself with `guild plugin install claude_code` after the CLI is on PATH. Confirm the plugin is genuinely absent first.

Codex

On a DAC ChatGPT Enterprise workspace there is normally nothing to install: DAC Guild is workspace-managed, so start a task and ask Guild for something. First test Guild directly in the current task. Check `codex plugin list`, `codex mcp list`, and a Guild skill lookup. If the current task lacks the newly installed tools or guidance, explain that it may retain its initial plugin context and suggest the user start a new Codex task. Provide a copyable handoff containing the user's actual request and verified setup state, without credentials; create a task only if the user explicitly asks. Restart the app only if that new task still does not load the installed plugin or tools.
If the entry is missing or disconnected: In Codex desktop, select the DAC workspace and open Plugins. If DAC Guild is available in the workspace-provided section, install or enable it and use its connection control. The workspace plugin supplies Guild skills and its connection; Compliance API ingestion supplies tracing with no local hooks and no Guild CLI.
Advanced fallback for remote, scripted, or UI-blocked environments: install the checksum-verified public Guild CLI and stage its bundled Codex plugin payload. Windows x64 PowerShell: iwr https://guild.dacgroup.com/api/v1/install.ps1 -UseBasicParsing | iex; & $installPath plugin install codex. macOS Apple silicon or Linux x64: curl -fsSL https://guild.dacgroup.com/api/v1/install.sh | sh && "$HOME/.local/bin/guild" plugin install codex. This path does not clone the private Guild repository, install Guild lifecycle hooks, or require a separate guild login. Authenticate its hosted MCP registration with codex mcp login guild.
If plugin installation is blocked, use Tools-only mode: run codex mcp add guild --url https://mcp.guild.dacgroup.com/mcp, then codex mcp login guild. Hosted tools and Compliance API tracing still work; report packaged local plugin skills separately.

Cursor

Preferred: install/update the public Guild CLI and the shipped Cursor adapter. Windows x64 PowerShell: iwr https://guild.dacgroup.com/api/v1/install.ps1 -UseBasicParsing | iex; & $installPath plugin install cursor. macOS Apple silicon or Linux x64: curl -fsSL https://guild.dacgroup.com/api/v1/install.sh | sh && "$HOME/.local/bin/guild" plugin install cursor. This writes both ~/.cursor/mcp.json and ~/.cursor/hooks.json.
If the adapter is unavailable, continue temporarily in degraded Tools-only mode and report that lifecycle tracing is not active: add { "mcpServers": { "guild": { "url": "https://mcp.guild.dacgroup.com/mcp", "transport": "http" } } } to ~/.cursor/mcp.json.

VS Code

Add to .vscode/mcp.json: { "servers": { "guild": { "type": "http", "url": "https://mcp.guild.dacgroup.com/mcp" } } }

ChatGPT

In Settings → Apps & Connectors → Create, use connector URL: https://mcp.guild.dacgroup.com/mcp/chatgpt

Hermes

Register the hosted HTTP MCP server https://mcp.guild.dacgroup.com/mcp in your Hermes MCP config. Local Guild stdio is retired.

Antigravity

Add mcpServers.guild.serverUrl = "https://mcp.guild.dacgroup.com/mcp" to ~/.gemini/antigravity/mcp_config.json (desktop) or ~/.gemini/antigravity-cli/mcp_config.json (CLI)

opencode

Install or update the public Guild CLI, then log in from a shell. Windows x64 PowerShell: iwr https://guild.dacgroup.com/api/v1/install.ps1 -UseBasicParsing | iex; & $installPath login. macOS Apple silicon or Linux x64: curl -fsSL https://guild.dacgroup.com/api/v1/install.sh | sh && "$HOME/.local/bin/guild" login. Load GUILD_MCP_TOKEN from ~/.guild-mcp/credentials.json without printing it, then add to opencode.json: { "mcp": { "dac-guild": { "type": "remote", "url": "https://mcp.guild.dacgroup.com/mcp", "headers": { "Authorization": "Bearer {env:GUILD_MCP_TOKEN}" }, "oauth": false } } }.

Other MCP-capable harnesses

Register the hosted HTTP MCP server https://mcp.guild.dacgroup.com/mcp using your harness's MCP config. Local Guild stdio is retired.

Local lifecycle layer

Hosted MCP is the primary Guild tool plane and keeps working on its own. Claude Code and Cursor also install a CLI-backed local plugin for doctor and lifecycle tracing, and its credential is part of a complete setup for those two: hosted tools still run without it, but the result is reported as degraded rather than complete. Codex desktop normally gets the Guild plugin from its workspace catalog; the bundled CLI installer is an advanced fallback for remote, scripted, or blocked catalog installs. If a required local plugin or lifecycle layer is unavailable, continue in hosted MCP Tools-only mode so core tools still work, but report the missing local capability as degraded rather than calling setup complete.

Claude Code

Fallback local tracing login only when MCP provisioning is unavailable. Windows x64 PowerShell: $guild = if (Test-Path "C:\source\guild.exe") { "C:\source\guild.exe" } else { Join-Path $env:LOCALAPPDATA "Programs\guild\guild.exe" }; & $guild login --no-browser --scopes "mcp:full offline_access". macOS Apple silicon or Linux x64: "$HOME/.local/bin/guild" login --no-browser --scopes "mcp:full offline_access".
Verify with /dac-guild:guild-doctor. /reload-plugins is enough only for a later plugin-only refresh when `guild` was already available.
Diagnose a faulty install with `guild doctor --harness claude_code --verbose`. Preserve a team-managed or marketplace plugin: run `guild plugin install claude_code` only when Claude reports no Guild plugin at all. Do not add the private Guild Git repository as a Claude marketplace.

Cursor

The shipped adapter command is guild plugin install cursor. Restart Cursor and verify the Guild MCP server and lifecycle-hook entries load.
Local tracing login, required for full Cursor setup. Windows x64 PowerShell: $guild = if (Test-Path "C:\source\guild.exe") { "C:\source\guild.exe" } else { Join-Path $env:LOCALAPPDATA "Programs\guild\guild.exe" }; & $guild login --no-browser --scopes "mcp:full offline_access". macOS Apple silicon or Linux x64: "$HOME/.local/bin/guild" login --no-browser --scopes "mcp:full offline_access". The hooks fail safely, but report missing lifecycle tracing as degraded rather than complete.

Hermes(local adapter coming soon)

Plugin + lifecycle hooks: coming soon (tracked by todo 569). For now, add only the Guild MCP server above — you still get tools, skills, memory, and personality.

Other MCP-capable harnesses

No hook layer here — the Guild MCP server alone still gives you tools, skills, memory, and personality.

Loading manual setup options…

Go to https://guild.dacgroup.com/install/agent and set up Guild for me. Detect this harness and operating system, use the recommended plugin when supported or the hosted MCP fallback, connect and prove Guild tools first, show me what works now, then explore Guild skills from the remote catalog.

Managed distribution first, advanced fallback when needed

Local lifecycle layer

Install Guild

Find your setup

Codex or ChatGPT on DAC Enterprise

Claude Code on the DAC Claude team

Everything else

After you connect: make Guild yours

Managed distribution first, advanced fallback when needed

Agent playbook

Identify your harness

Choose one installation lane

Authenticate the applicable Guild tools

Prove Guild tools and show value

Explore Guild skills

Make Guild yours and try Quickpages

Offer governed personalization

Setup path by harness

Claude Code

Codex

Cursor

VS Code

ChatGPT

Hermes

Antigravity

opencode

Other MCP-capable harnesses

Local lifecycle layer

Claude Code

Cursor

Hermes(local adapter coming soon)

Other MCP-capable harnesses

Install Guild

Find your setup

Codex or ChatGPT on DAC Enterprise

Claude Code on the DAC Claude team

Everything else

After you connect: make Guild yours

Managed distribution first, advanced fallback when needed

Agent playbook

Identify your harness

Choose one installation lane

Authenticate the applicable Guild tools

Prove Guild tools and show value

Explore Guild skills

Make Guild yours and try Quickpages

Offer governed personalization

Setup path by harness

Claude Code

Codex

Cursor

VS Code

ChatGPT

Hermes

Antigravity

opencode

Other MCP-capable harnesses

Local lifecycle layer

Claude Code

Cursor

Hermes(local adapter coming soon)

Other MCP-capable harnesses