Skip to main content

vulkro install-extension

Detect a local editor and install the Vulkro extension into it. Vulkro looks for VS Code, Cursor, Windsurf, and VSCodium, downloads the packaged .vsix from the Vulkro CDN, and installs it. It asks before installing.

This works even when the editor's code-style command is not on your PATH: Vulkro finds the editor's own CLI in its install location. If no editor is found it prints how to add the code command or install the .vsix by hand. After install, the extension drives the same device login as vulkro login.

Two ways to supply the package:

  • Default: download the .vsix from the CDN. This needs the network, and is refused under VULKRO_OFFLINE (or --offline).
  • --vsix <PATH>: install a local .vsix you already have. This makes no network call and works air-gapped.

Usage​

vulkro install-extension [OPTIONS]

Flags​

FlagDescriptionDefault
--editor <EDITOR>Install into only this editor, by CLI name (code, cursor, windsurf, codium).every detected editor
--vsix <PATH>Install a local .vsix instead of downloading. Makes no network call, so it works offline.download from the CDN
--yesInstall without the confirmation prompt.prompt first
--offlineHard-disable every outbound network call for this run (same as VULKRO_OFFLINE=1). The CDN download is then refused; a local --vsix still installs.off

Environment variables​

VariableEffect
VULKRO_VSIX_URLFull URL of the .vsix to install, overriding the CDN. Use it for a self-hosted mirror, an air-gapped host, or testing.
VULKRO_OFFLINEWhen set, blocks the CDN download (and every other outbound call). A local --vsix install still works.

Exit codes​

  • 0 the extension was installed into at least one editor.
  • 2 error: no editor was found, the download failed, or an editor's install command failed.

This command does not report findings, so it never exits 1.

Examples​

# Detect every installed editor and install the extension into each.
vulkro install-extension

# Only Cursor, no prompt.
vulkro install-extension --editor cursor --yes

# Air-gapped host: install a local package with no network access.
vulkro install-extension --vsix ./vulkro-extension.vsix
  • VS Code security extension - what the extension does, and installing it from the Marketplace by hand.
  • vulkro lsp - the language server the extension is a client of, and how to wire up Neovim, Helix, Emacs, Zed, and Sublime.
  • vulkro login - the device login the extension drives after install.

Command reference​

Generated from vulkro help install-extension on vulkro 0.26.0. This block is the authoritative flag, usage, and exit-code reference for this command; the prose above is the friendly explanation. Do not edit this block by hand; run npm run docs:cli after a release.

Install the Vulkro extension into VS Code, Cursor, Windsurf or VSCodium.

Install the Vulkro VS Code extension into a detected editor (VS Code, Cursor, Windsurf, or VSCodium), downloading the package from the Vulkro CDN. Asks before installing. Works even when the editor's `code`-style command is not on your PATH: it finds the editor's own CLI in its install location. If no editor is found it prints how to add the `code` command or install the VSIX by hand. The extension then drives the same device login as `vulkro login`.

VULKRO_VSIX_URL   full URL of the .vsix to install, overriding the CDN (self-hosted mirror, air-gap, or testing).

Exit codes: `0` installed into at least one editor; `2` error (no editor found, download failed, or an editor install failed).

Usage: vulkro install-extension [OPTIONS]

Options:
      --offline
          Hard-disable every outbound network call for this run (sets VULKRO_OFFLINE=1). Blocks the CVE feed, the license heartbeat, the update check, webhooks, and any cloud AI endpoint; a loopback model (http://127.0.0.1, http://localhost) is still allowed. Equivalent to exporting VULKRO_OFFLINE=1, and the flag wins when both are set

      --yes
          Install without the confirmation prompt

      --editor <EDITOR>
          Only this editor, by CLI name (code | cursor | windsurf | codium). Default: every detected editor

      --vsix <PATH>
          Install a local .vsix instead of downloading (offline / testing)

  -h, --help
          Print help (see a summary with '-h')
Last updated on