Jeremy McSpadden 2df27c5179 feat(vscode): add marketplace-ready files for VS Code extension publishing

Adds everything needed to publish the extension to the VS Code Marketplace:

- README.md — full feature documentation with commands table, keyboard
  shortcuts, configuration reference, quick start guide, and @gsd chat
  participant usage
- CHANGELOG.md — initial 0.1.0 release notes
- .vscodeignore — excludes src/, tsconfig, maps from the .vsix package
- .gitignore — excludes dist/ and *.vsix from version control
- LICENSE — MIT license copied from repo root
- package.json — adds repository, homepage, bugs, keywords, galleryBanner
  fields required by the marketplace; adds @vscode/vsce to devDependencies;
  adds publish script

Verified: `npm run package` produces a clean 30KB .vsix with no warnings.
Run `npm run publish` with a VSCE_PAT token to publish.

2026-03-16 19:09:28 -05:00

3.1 KiB

Raw Blame History

GSD — VS Code Extension

Control the GSD coding agent directly from VS Code. Run autonomous coding sessions, chat with @gsd in VS Code Chat, and monitor your agent from a sidebar dashboard — all without leaving the editor.

Requirements

GSD must be installed before activating this extension:

npm install -g gsd-pi

Node.js ≥ 20.6.0 and Git are required.

Features

Sidebar Dashboard

Click the GSD icon in the Activity Bar to open the agent dashboard. It shows:

Connection status (connected / disconnected)
Active model and provider
Thinking level
Token usage and session cost
Quick action buttons: Start, Stop, New Session, Compact, Abort

Chat Integration (`@gsd`)

Use @gsd in VS Code Chat (Ctrl+Shift+I) to send messages to the agent:

@gsd refactor the auth module to use JWT
@gsd /gsd auto
@gsd what's the current milestone status?

Commands

All commands are accessible via Ctrl+Shift+P:

Command	Description
GSD: Start Agent	Connect to the GSD agent
GSD: Stop Agent	Disconnect the agent
GSD: New Session	Start a fresh conversation
GSD: Send Message	Send a message to the agent
GSD: Abort Current Operation	Interrupt the current operation
GSD: Steer Agent	Send a steering message mid-operation
GSD: Switch Model	Pick a model from QuickPick
GSD: Cycle Model	Rotate to the next configured model
GSD: Set Thinking Level	Choose off / low / medium / high
GSD: Cycle Thinking Level	Rotate through thinking levels
GSD: Compact Context	Manually trigger context compaction
GSD: Export Conversation as HTML	Save the session as HTML
GSD: Show Session Stats	Display token usage and cost
GSD: Run Bash Command	Execute a shell command via the agent
GSD: List Available Commands	Browse and run GSD slash commands

Keyboard Shortcuts

Shortcut	Command
`Ctrl+Shift+G Ctrl+Shift+N`	New Session
`Ctrl+Shift+G Ctrl+Shift+M`	Cycle Model
`Ctrl+Shift+G Ctrl+Shift+T`	Cycle Thinking Level

Configuration

Setting	Default	Description
`gsd.binaryPath`	`"gsd"`	Path to the GSD binary if not on PATH
`gsd.autoStart`	`false`	Start the agent automatically when the extension activates
`gsd.autoCompaction`	`true`	Enable automatic context compaction

Quick Start

Install GSD: npm install -g gsd-pi
Install this extension
Open a project folder in VS Code
Ctrl+Shift+P → GSD: Start Agent
Use @gsd in Chat or the sidebar to interact with the agent

How It Works

The extension spawns gsd --mode rpc in the background and communicates over JSON-RPC via stdin/stdout. All 25 RPC commands are supported, including streaming events for real-time sidebar updates.

3.1 KiB Raw Blame History