weave-install

name	weave-install
description	This skill should be used when the user wants to "install the weave plugin", "set up weave", "install weave-claude-plugin", "configure weave for the first time", "get started with weave tracing", or needs to complete the initial setup of the Weave Claude Code plugin including dependency installation and project configuration.

Weave Claude Code Plugin — Install

Complete the full installation and initial configuration of the Weave Claude Code plugin.

Step 1 — Check for CLI

Run:

which weave-claude-plugin

If not found, install it:

npm install -g weave-claude-plugin

Then verify it is now available:

which weave-claude-plugin

If the install fails (e.g., permission error), retry with sudo npm install -g weave-claude-plugin after confirming with the user. Do not proceed to Step 2 until which weave-claude-plugin succeeds.

Step 2 — Run Install

Run:

weave-claude-plugin install

This creates ~/.weave_claude_plugin/settings.json, registers the plugin in Claude Code's marketplace, and installs hooks. If the command reports the installation already exists, continue to Step 3 to verify configuration.

If --force is needed to reinstall, run:

weave-claude-plugin install --force

Step 3 — Configure Weave Project

Check if weave_project is already set:

weave-claude-plugin config get weave_project

If not set (output is (not set)), ask the user for their Weave entity and project name in the format entity/project, then set it:

weave-claude-plugin config set weave_project ENTITY/PROJECT

Step 4 — Configure API Key

Check if wandb_api_key is configured or the WANDB_API_KEY environment variable is set. Run:

weave-claude-plugin config show

If wandb_api_key shows (not set) and no env var is active, ask the user for their W&B API key (available at https://wandb.ai/authorize) and set it:

weave-claude-plugin config set wandb_api_key API_KEY

Step 5 — Verify

Run a final status check:

weave-claude-plugin status

Confirm all items show ✓. If anything shows ✗, diagnose and fix before finishing.

Report the result to the user. On success, tell them that Claude Code sessions will now be automatically traced to their Weave project starting from the next session.