Skip to main content

Wire VS Code Extension

The Wire VS Code extension brings Wire status and artifact management into Visual Studio Code. It provides a sidebar panel, inline artifact decorations, and quick-run command shortcuts — without leaving your editor.

What the extension provides

  • Wire Explorer sidebar — a tree view of all releases in the open workspace, showing phase, artifact status, and the last-run command
  • Status bar indicator — a compact status line showing the current engagement phase and last artifact state
  • Quick-run commands — run any Wire command from the VS Code command palette (Cmd+Shift+PWire: Run Command)
  • Artifact preview — click any artifact in the explorer to open it in a preview panel (read-only rendered Markdown)
  • Inline review decorations — generated files are annotated with their Wire artifact status (Generated, Validated, Approved) in the editor gutter

Installing the extension

The extension is published to the VS Code Marketplace as Wire Framework.

code --install-extension rittmananalytics.wire-framework

Or search for "Wire Framework" in the Extensions panel.

Prerequisites

  • Claude Code CLI installed and on $PATH
  • The Wire plugin installed in Claude Code (/plugin install wire@rittman-analytics)
  • VS Code 1.80 or later

Using the Wire Explorer

Open the Wire Explorer from the Activity Bar (the Wire icon). The explorer shows:

WIRE FRAMEWORK
└── 20240115_barton_peveril_full_platform
├── Phase: Development
├── Requirements ✓ (all approved)
├── Design ✓ (all approved)
└── Development
├── ingestion ✓ Approved
├── dbt-models (students) ✓ Approved
├── dbt-models (finance) ⚠ Validation failures
└── dbt-models (attendance) — Not started

Click any artifact node to open the artifact document. Right-click for the context menu:

  • Run generate — run the generate command for this artifact
  • Run validate — run the validate command
  • Open review — open the artifact for review in the Studio web panel
  • Copy command — copy the full Wire command to the clipboard

Running Wire commands from VS Code

Command palette: Cmd+Shift+P → type "Wire" to see all Wire commands. Select a command and Wire will prompt for the release folder if not already set.

Status bar: click the Wire status bar item to open a quick-pick of available commands for the current release.

Keyboard shortcut: assign wire.runLastCommand to a keyboard shortcut to re-run the last Wire command without opening the palette.

Setting the active release

If the workspace contains multiple Wire releases, set the active release from the status bar:

Wire: 20240115_barton_peveril ▾

Click the status bar item to change the active release. All quick-run commands run against the active release.

Extension settings

Open VS Code settings (Cmd+,) and search for "Wire" to configure:

SettingDefaultDescription
wire.claudeCodePathclaudePath to the Claude Code CLI binary
wire.autoRefreshtrueAuto-refresh the explorer after a command completes
wire.showStatusBartrueShow the Wire status bar item
wire.defaultRelease``Pin a specific release folder as default
wire.artifactDecorationstrueShow artifact status in the editor gutter

Artifact gutter decorations

When you open a file that is a Wire-generated artifact (identified by the Wire header comment), the extension adds a decoration in the gutter showing the artifact's current status. Hover over the decoration to see the full status and the last action taken.

Files in non-approved state show a yellow dot; approved files show a green dot; files with validation failures show a red dot.