> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weaveos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Weave plugin installation

> Find installation instructions for the Claude Code, Cursor, GitHub Copilot, Codex, and Grok Build plugins

Weave plugins capture per-developer AI coding activity and send telemetry to Weave. Use this page to choose a plugin, then follow its dedicated installation guide.

On the **Data** page, **Enhanced AI tools** offers a combined installer: pick one or more plugins (Claude Code, Cursor, Copilot, Codex, and Grok Build), generate a single install command, or jump to separate setup for GitAI and Weave Router.

The Claude Code, Cursor, Codex, and Grok Build plugins use a local hook installer. Grok Build setup is macOS/Linux only (use WSL on Windows). GitHub Copilot uses Copilot Chat's built-in OpenTelemetry export and requires environment variables. The [GitHub Copilot integration](/ai-tools/copilot) is separate: it provides GitHub-reported organization usage and billing data.

<Note>
  Plugins are telemetry, not [Weave Router](/router/overview). Plugins observe
  activity and send it to Weave; Router changes which model serves a request.
  You can use either or both.
</Note>

## Choose a plugin

* [Install the Claude Code plugin](/ai-tools/claude-code-plugin)
* [Install the Cursor plugin](/ai-tools/cursor-plugin)
* [Install the GitHub Copilot plugin](/ai-tools/copilot-plugin)
* [Install the Codex plugin](/ai-tools/codex-plugin)
* [Install the Grok Build plugin](/ai-tools/grok-build-plugin)

## Before you start

* For a shared install, an organization admin creates a plugin API key in Weave. Claude Code, Cursor, Copilot, Codex, and Grok Build also let any signed-in member create a personal install command that writes telemetry onto their own account. The full key is shown only once, so save the generated command or configuration securely.
* Install the plugin separately for each developer machine, unless you are using an MDM or fleet deployment described in the tool's guide.
* Claude Code, Cursor, Codex, and Grok Build hook runtimes require **Node.js 18 or later**. GitHub Copilot's native OpenTelemetry export does not require Node.js.
* Use the generated commands and configuration snippets from Weave as the source of truth for your organization and deployment environment.

## Shared privacy controls

The [Claude Code](/ai-tools/claude-code-plugin#content-settings), [Cursor](/ai-tools/cursor-plugin#content-settings), [Codex](/ai-tools/codex-plugin#content-categories), and [Grok Build](/ai-tools/grok-build-plugin#content-categories) guides document the five content categories available to their installers: prompt bodies, agent messages, tool input/output, file paths, and git context. Each guide explains the individual flags and the `--privacy-mode` switch.

GitHub Copilot has one content setting, `COPILOT_OTEL_CAPTURE_CONTENT`, which controls content capture for Copilot Chat. The organization-wide **Telemetry content retention** policy is the floor for every member. Configure it under **Settings** → **Organization** → **General** → **Telemetry content retention**. Members can choose a stricter policy, but cannot override an organization restriction.

When prompt retention is off, Claude Code and Cursor hold prompt text until it is scored and then purge it. Grok Build has no hold, so Weave drops its prompt text at ingest.

## After installation

Follow the verification and troubleshooting steps in the dedicated plugin guide. In general:

1. Run the plugin in the developer's own user context.
2. Start a new session, or restart the relevant application when the guide requires it.
3. Check plugin activity and member attribution in **Data**.
4. Review reports supported by the selected plugin, including [AI skills](/reports/ai-skills) where available. Copilot's [AI code LOC](/metrics/ai-code-loc) and [AI output percentage](/metrics/ai-output-percentage) require the [GitHub Copilot integration](/ai-tools/copilot).

## Related guides

* [AI tools overview](/ai-tools/overview) — all supported AI tool integrations
* [Connecting your data](/tutorials/connecting-your-data) — full integration onboarding
* [Claude Code](/ai-tools/claude-code) — managed settings, Compliance API, and cost integrations
* [Cursor](/ai-tools/cursor) — Admin API usage and spend
* [GitHub Copilot](/ai-tools/copilot) — GitHub usage and billing
* [Codex](/ai-tools/codex) — Codex Analytics API and OpenAI direct API usage


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.