GateStack VS Code Extension
Operator visibility and directive-entry surface for the GateStack AI Agent Control Plane.
Features
- Projects View — List organization projects in the sidebar
- Pending Gates View — See gates awaiting approval
- Incidents View — View Watchman incidents
- Draft Directive Creation — Submit directives from your editor (draft only, no execution)
- API Health — Check GateStack API status
- Connection Status — See key prefix and connection state
Distribution Status
This extension is distributed as a local VSIX file only. It is not listed on the VS Code Marketplace and has not been publicly released. Publishing requires separate owner approval.
Manual VS Code UI smoke testing has been deferred by owner decision (Extension1C-FOLLOWUP).
Installation
Sideload the extension locally:
cd extensions/vscode
npm install
npm run compile
npx @vscode/vsce package --no-dependencies
code --install-extension gatestack-0.1.0.vsix --force
Connect
- Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
- Run "GateStack: Connect"
- Enter your API key (input is masked)
- Key is stored securely in VS Code SecretStorage
Commands
| Command |
Description |
| GateStack: Connect |
Authenticate with API key |
| GateStack: Disconnect |
Remove stored API key |
| GateStack: Show Health |
Display API health status |
| GateStack: List Projects |
Refresh projects sidebar |
| GateStack: Show Pending Gates |
Refresh gates sidebar |
| GateStack: Create Draft Directive |
Submit a draft directive |
| GateStack: Show Connection Status |
Show key prefix and auth state |
Required API Key Scopes
| Feature |
Scope |
| Health |
health:read |
| Projects |
projects:read |
| Gates |
gates:read |
| Incidents |
incidents:read |
| Directives |
directives:write |
Draft Directive Creation
When creating a directive:
- Enter an objective (required)
- Select priority (low/normal/high/critical)
- Optionally include selected editor text as context
- Selected text is never sent without your confirmation
- Preview is available before submission
The directive is created as draft only. No execution is started. The directive requires separate review and approval.
Security
- API key stored in VS Code SecretStorage (encrypted)
- Full key is never displayed — only the prefix
- Key is never written to workspace files or settings
- Authorization header is never logged
- Selected text is never sent without explicit confirmation
- Extension does not scan or index your workspace
Settings
| Setting |
Default |
Description |
gatestack.apiBaseUrl |
https://api.getgatestack.com |
API base URL |
gatestack.defaultProjectId |
(empty) |
Default project ID |
gatestack.enableStatusBar |
true |
Show status bar item |
gatestack.autoRefreshInterval |
60 |
Refresh interval (seconds) |
Do not add an apiKey setting. Use GateStack: Connect instead.
Limitations
This extension supports only the proven live GateStack public API:
- Not available: Gate approve/reject/modify (API deferred)
- Not available: Project create/update (API deferred)
- Not available: Deploy/rollback (not an extension concern)
- Not available: AI code generation (extension is not a builder)
- Not available: Source file mutation (extension does not modify code)
- Not available: Workspace scanning (no background file analysis)
- Not available: Adapter/provider/plugin execution
The extension does not bypass Watchman controls.
