Claude Orchestrator VSCode Extension

Polls the TrendingIdeas API for new idea issues and launches Claude Code sessions as VSCode terminal tabs. Authenticates via OAuth 2.1 (PKCE + DCR) against the platform's Supabase authorization server.

What it does

• Connects to TrendingIdeas with a real OAuth consent flow — no API keys to paste.
• Reads the workspace's .project_idea file to learn which idea it's working on, and polls that idea's idea_issues.
• For each issue in backlog / todo state, transitions it to in_progress and spawns a Claude session running claude --worktree <name> --permission-mode plan <prompt>.
• Tokens (access + refresh) are stored in VSCode SecretStorage and refreshed transparently.

The .project_idea file

The workspace must contain a .project_idea file at its root identifying which idea's issues to poll:

{ "ideaId": "<idea UUID>" }

A bare UUID (the file containing just the id) also works. This file is created automatically by the MCP initialize_project flow when scaffolding a project from an idea; you can also write it by hand.

Setup

1. Open the project folder (containing a .project_idea file) in VSCode.

2. In your workspace or user settings, set the API base:

   { "claudeOrchestrator.apiBase": "https://api.trendingideas.com/api" }
   

3. Run Claude Orchestrator: Connect to TrendingIdeas from the command palette. A browser tab opens to the consent screen — review and click Approve.

4. Run Claude Orchestrator: Start Polling.

OAuth flow

On first connect:

1. The extension fetches /.well-known/oauth-protected-resource/api from your configured apiBase, then follows the link to the authorization server's metadata.
2. It dynamically registers itself with the AS (RFC 7591) using a loopback redirect_uri like http://127.0.0.1:54322/callback. The client_id is cached in SecretStorage.
3. It generates a PKCE pair, opens the browser to the authorization endpoint with the openid scope, and starts a local HTTP server on the callback port.
4. After you approve, the AS redirects to the loopback. The extension exchanges the code for tokens at the token endpoint and stores them in SecretStorage.
5. Subsequent polls refresh the access token automatically when it's within 60s of expiry.

Use Claude Orchestrator: Disconnect to clear all stored credentials (tokens and dynamic-client registration).

Settings

Commands

Development

cd vscode-extension
npm install
npm run build      # bundles to dist/extension.cjs via esbuild
npm run typecheck  # tsc --noEmit

Open the vscode-extension/ folder in VSCode and press F5 to launch an Extension Development Host with the extension loaded.

Caveats

• The callback server binds to one of ports 54322–54325 on 127.0.0.1. If all four are in use, the OAuth flow fails — close whatever else is bound and retry.
• The dynamically registered OAuth client persists across VSCode sessions (in SecretStorage). Disconnect to force re-registration with a different redirect URI.
• claude must be on PATH (or set claudeOrchestrator.claudeCommand).