Partiri VS Code extension

Overview

Partiri Cloud for VS Code brings service management into the editor: create, deploy, pause, and monitor services from a dedicated activity bar, edit .partiri.jsonc with live diagnostics and completion, and run the same actions the CLI exposes through commands and a wizard. It's a thin shell over the partiri CLI — it invokes partiri CLI commands and speaks LSP to partiri lsp, and never talks to api.partiri.cloud directly.

Installation

The extension isn't published to the official Visual Studio Marketplace — publishing there requires enrolling in a Microsoft publisher account tied to Azure DevOps, which the project has chosen not to require. Instead, it's published to the Open VSX Registry and attached as a downloadable .vsix to every GitHub release.

Open VSX Registry

Editors that use Open VSX as their default marketplace — VSCodium, Gitpod, Eclipse Theia, and others — can install it the normal way: search for "Partiri Cloud" in the Extensions view, or install directly from open-vsx.org/extension/partiri-cloud/partiri.

Manual install (.vsix)

For stock VS Code, or any editor, download the latest partiri-<version>.vsix from the GitHub releases page, then either open the Extensions view, click the "..." menu, and choose "Install from VSIX...", or install it from a terminal:

code --install-extension partiri-<version>.vsix

Restart the editor if prompted — the Partiri icon then appears in the activity bar.

Requirements

The extension is a thin shell over the partiri CLI, not the API, and requires the CLI installed and on your PATH — version 0.3.0 or newer, the first release with partiri lsp. Install it via Cargo:

cargo install partiri-cli

Or via npm:

npm install -g @partiri/cli

The extension looks for the binary in this order: the partiri.binaryPath setting, PATH, ~/.cargo/bin, then the npm global bin directory. If none resolve, it shows a non-blocking notification with install guidance rather than blocking the editor. If the resolved CLI is older than 0.3.0, both the LSP integration and all action commands stay disabled until you update.

Features

  • A dedicated Partiri activity bar: Local Configs and Resources trees for picking a service, with Details, Monitoring, Recent Jobs, and Logs views that follow the current selection.
  • A New Service wizard (workspace → project → name → deploy type → source → region → pod) and a Pull Existing Service command that writes a .partiri.jsonc for a service you already created elsewhere.
  • LSP-powered diagnostics, completion (including live UUIDs), and hover for .partiri.jsonc, provided entirely by partiri lsp.
  • Sign in through the integrated terminal (partiri auth login) with status polling, or a masked API key prompt as a headless fallback.
  • Native confirmation dialogs before every destructive action — deploy, kill, pause, push, and env replace.
  • No telemetry, usage analytics, or crash reporting of any kind.

Settings

Configure the extension under File → Preferences → Settings → Extensions → Partiri Cloud, or by editing settings.json directly:

SettingDescription
partiri.binaryPathAbsolute path to the partiri binary. Overrides PATH / ~/.cargo/bin / npm global bin discovery.
partiri.apiUrlOverrides the Partiri API URL, passed through as PARTIRI_API_URL. Leave empty to use the CLI's own default.
partiri.timeoutSecondsSubprocess timeout, in seconds, for partiri CLI invocations. Default 60.
partiri.remoteValidationControls the partiri-remote LSP diagnostic source (UUID existence/pairing, source reachability, balance warnings). off or onSave (default).
partiri.lsp.enabledEnable the partiri lsp language server for .partiri.jsonc. Default true.