Serge — VS Code / Cursor extension
Multi-agent extension with orchestrator, 10 root addon packs, React dashboard, CAD billing (39 / 99 / 229), and AWS Bedrock (BYOK + platform).
End users (Marketplace)
- Install Serge from VS Code / Cursor Extensions search (publisher
413287184954, id 413287184954.serge), or install the local VSIX under releases/ (code-insiders --install-extension releases/serge-latest.vsix).
- Command Palette → Serge: Open Dashboard, or click the Serge icon in the Activity Bar. On activate the extension starts an embedded API on
127.0.0.1:<ephemeral> (addons / plans / chat). Optional remote SoT: https://www.select-ai.cloud.
- Owner Bedrock (aiMode
platform / serge): put PLATFORM_AWS_* in D:\.serge-ext-vscode\.env (gitignored). Optional mirror: server/.env (see server/.env.example).
- Optional BYOK: Serge: Configure Bedrock (BYOK) for chat.
You do not need serge-ship-all or a separate local npm run dev:server for the dashboard.
URL policy: shared/awsServerUrl.ts (legacy ports 8788 / 18765 / 5188 blocked; loopback embedded kept).
Canonical checkout (maintainers)
D:\.serge-ext-vscode (WSL: /mnt/d/.serge-ext-vscode)
Addon packs at repo root (deploy-serge-addons-v2.ps1):
tree-generator … test-runner-ai
Integrated terminals (dev workspace)
Configured in .vscode/settings.json. In Cursor/VS Code:
Terminal ▸ New Terminal ▸ ▾ (profile picker) — choose:
| Profile |
Shell |
| PowerShell / PowerShell 7 |
pwsh (default on Windows) |
| Windows PowerShell |
Windows PowerShell 5.x |
| Command Prompt |
cmd.exe |
| Git Bash |
Git for Windows bash |
| WSL / WSL (Ubuntu) / WSL (Ubuntu-24.04) |
wsl.exe → distro |
| Serge Dev (PowerShell) |
pwsh + cd workspace + PATH for local tools |
| Serge Dev (WSL) |
Ubuntu-24.04 at /mnt/d/.serge-ext-vscode + ~/.local/bin |
| Serge Dev (Git Bash) |
Git Bash at workspace |
| bash / Serge Dev (bash) |
When the window is a Linux/WSL remote |
Default Windows profile: PowerShell. Default Linux: bash.
F5 Serge: Extension launch config is unchanged (.vscode/launch.json).
Maintainers only — ship-all
Default: package + install + health. No Azure required.
cd D:\.serge-ext-vscode
.\scripts\serge-ship-all.ps1
cd /mnt/d/.serge-ext-vscode
bash scripts/serge-ship-all.sh # or: npm run ship
Marketplace listing (searchable) — Manage UI upload
CLI vsce publish needs a Microsoft Azure DevOps PAT. If you have no Azure, do not create one — upload the VSIX in the portal:
- Run ship-all (above) → get
releases/serge-latest.vsix
- Open https://marketplace.visualstudio.com/manage/publishers/413287184954
- Upload that VSIX (extension id
413287184954.serge)
-Publish / --publish without VSCE_PAT prints this UI path and exits cleanly (not a TF400813).
Optional Open VSX only: set OVSX_PAT from https://open-vsx.org/user-settings/tokens (independent of Azure).
Bedrock helpers (never write secrets into the repo):
.\scripts\configure-bedrock.ps1
.\scripts\configure-bedrock.ps1 -WritePlatformEnv # server/.env only (gitignored)
Secrets
- BYOK: Serge: Configure Bedrock (BYOK) → VS Code SecretStorage (never commit).
- Platform (optional, maintainers):
server/.env ← PLATFORM_AWS_* (from .env.example).
Remote
Origin: quasimodo-ai/serge_vscode
