PowerPM VS Code Extension

Trigger Claude Code to manage PowerPM tickets directly from VS Code.

Installation

From Marketplace (Recommended)

code --install-extension WisePelicanLLC.powerpm-vscode

Or in VS Code:

1. Open Extensions (Cmd+Shift+X)
2. Search for WisePelicanLLC.powerpm-vscode
3. Click Install

Updates are automatic - VS Code will update the extension whenever a new version is published.

From VSIX (Manual)

If you have a .vsix file:

1. Open Command Palette (Cmd+Shift+P)
2. Type "Extensions: Install from VSIX..."
3. Select the .vsix file

Basic Usage (No API Key Needed)

These commands work immediately - they open Claude Code in a terminal:

Show Tickets for Current Repo

1. Open a project folder that's linked to PowerPM (e.g., core, boundary-service)
2. Press Cmd+Shift+P
3. Type "PowerPM: Show Tickets"
4. A terminal opens with Claude Code listing your tickets

Create a New Ticket

1. Press Cmd+Shift+P
2. Type "PowerPM: Create Ticket"
3. Enter the ticket title when prompted
4. Claude Code will create the ticket

Show Specific Ticket

1. Press Cmd+Shift+P
2. Type "PowerPM: Show Ticket"
3. Enter the ticket key (e.g., WPDEV-123)
4. Claude Code shows the ticket details

Check Work Queue

1. Press Cmd+Shift+P
2. Type "PowerPM: Check Work Queue"
3. Claude Code shows tickets in the "To Do" column

Status Bar

You'll see a "PowerPM" item in the bottom-left status bar. Click it to show tickets.

Background Polling (Optional)

To get automatic notifications when new tickets appear:

Step 1: Get Your PowerPM API Key

1. Go to PowerPM web app
2. Navigate to Settings → API Keys
3. Copy your API key

Step 2: Configure the Extension

1. Press Cmd+Shift+P
2. Type "PowerPM: Configure API Key"
3. Paste your API key (it's stored securely in VS Code's secret storage)

What Happens

• Every 5 minutes, the extension checks for tickets in "To Do" column
• If new tickets are found, you'll see a notification
• The status bar shows the count: PowerPM (3)
• Click the notification's "Open in Claude" button to handle them

Push Notifications from PowerPM Web

The extension can receive "push" notifications from the PowerPM web app.

How It Works

When someone clicks "Open in VS Code" on a ticket in PowerPM web, it opens VS Code and shows a notification with that ticket.

For PowerPM Web Integration

Add this link/button to the web app:

// JavaScript
function openInVSCode(ticketKey) {
  window.open(`vscode://powerpm.powerpm-vscode/ticket/${ticketKey}`, '_blank');
}

<!-- HTML -->
<a href="vscode://powerpm.powerpm-vscode/ticket/WPDEV-123">Open in VS Code</a>

Troubleshooting

"Claude Code not found"

Make sure Claude Code CLI is installed and in your PATH:

which claude

Extension not showing up

1. Check it's installed: code --list-extensions | grep powerpm
2. Reload VS Code: Cmd+Shift+P → "Developer: Reload Window"

Polling not working

1. Make sure you configured the API key: "PowerPM: Configure API Key"
2. Check VS Code's Output panel for errors: View → Output → select "PowerPM"

Can't detect repository

The extension needs the folder to be a git repo with a GitHub remote:

git remote -v
# Should show: origin git@github.com:owner/repo.git

Commands Reference