Swarm — VS Code extension
[^] Expertly inside VS Code. Sign in with your team token, pull approved prompts, and run
engineering tasks against your project — the assistant does the work and shows you the results.
This is the white-label client: it presents only the Expertly brand and the outcome of its work.
How it works internally is not exposed.
⚠️ Partial. Sign-in and the prompt library are live. Task-running is stubbed until the gateway
is available.
Install (private — not the VS Code Marketplace)
Download the latest .vsix from the repo (clients/swarm-vscode/releases/) and install it:
code --install-extension swarm-vscode-<version>.vsix
Or in VS Code: Extensions panel → ⋯ → Install from VSIX… → pick the file.
Sign in
You authenticate with a personal access token (no browser flow in the client):
- Open the backoffice → Tokens → Generate token, and copy it.
- In VS Code run
Swarm: Sign In and paste the token. It's validated and stored in VS Code
SecretStorage. The token carries your identity + role, so the same access rules apply as in
the backoffice.
Commands
| Command |
Does |
Swarm: Sign In |
paste a personal token → validated → stored in SecretStorage |
Swarm: Sign Out |
clears the stored token |
Swarm: Prompt Library |
fetch approved prompts → pick one → insert at cursor (or copy) |
Swarm: Run Task |
describe a task → stream the result into the Swarm panel (needs the gateway) |
Swarm: Show Last Run Trace |
(TODO) run-detail view |
Config: swarm.apiUrl (backoffice API — identity, roles, prompt library) and swarm.gatewayUrl
(task-running gateway).
Develop
cd clients/swarm-vscode
npm install
npm run build # esbuild → dist/extension.js
# then press F5 in VS Code to launch the Extension Development Host
Package a release
npm run package # → swarm-vscode-<version>.vsix
Distribution is private — the packaged .vsix is committed under releases/ in this repo, not
published to the VS Code Marketplace.
