Calagopus for VSCode
Browse and edit Calagopus server files and access the server console directly from VS Code.
Features
- Mount server files as a workspace folder over a virtual
calagopus:// filesystem.
- Edit, create, rename, and delete files and directories remotely with native VS Code tooling.
- Search across server files by name and content (when the proposed search APIs are enabled).
- Attach to the live server console as an integrated terminal, with full output streaming and command input.
- View server state in the status bar and trigger power actions (start, stop, restart, kill).
- Open servers and consoles via deep links using the
calagopus URI handler.
- Secure, persistent sign-in backed by VS Code's secret storage.
Commands
| Command |
Description |
Calagopus: Sign In |
Authenticate with your Calagopus panel. |
Calagopus: Sign Out |
Clear stored credentials. |
Calagopus: Open Server Files |
Pick a server and mount its files as a workspace folder. |
Calagopus: Open Server Console |
Pick a server and attach to its console. |
Calagopus: Server Power Action |
Start, stop, restart, or kill the active server. |
Deep links
The extension registers a calagopus URI handler. Open a server (mounting its files as a workspace folder) with:
vscode://calagopus.calagopus/open?origin=<panel-url>&server=<server-uuid>
| Param |
Description |
origin |
Panel base URL, e.g. https://panel.example.com. Required. |
server |
Server UUID. Required. |
apiKey |
Optional API key for an ephemeral, non-persisted session. |
console |
When truthy (1/true), also attach to the server console. |
file |
Optional path (relative to the server root) to open in the editor after mounting. |
When the link opens into a fresh window, the file explorer is revealed automatically.
Requirements
- VS Code
^1.120.0
- A Calagopus account with access to one or more servers
Building
pnpm install
pnpm compile
To produce an installable .vsix and install it locally:
pnpm package
pnpm code:install
| |
