ovsx


Command line interface for Eclipse Open VSX. Run it via npx or install it with
``
npm install --global ovsx
`

ovsx uses open-vsx.org as default instance for publishing and downloading extensions. If you are using a different instance, specify it via the --registryUrl (or -r) argument or an environment variable named OVSX_REGISTRY_URL.

$3

You can use ovsx for publishing VS Code extensions to an Open VSX instance. This is very similar to vsce, the publishing tool for the Visual Studio Code Marketplace.

You must create an Open VSX personal access token before you can use osvx to publish. You can either pass the token via the --pat (or -p) argument, or put it into an environment variable named OVSX_PAT.

Variants:
* ovsx publish
packages the extension in the current working directory using vsce and then publishes it.
* ovsx publish --packagePath
packages the extension in the given path using vsce and then publishes it.
* ovsx publish
publishes an already packaged file.

$3

The publisher field of your extension's package.json defines the namespace into which the extension will be published. Before you publish the first extension in a namespace, you must create it. This requires an access token as described above.

* ovsx create-namespace
creates the specifed namespace. The name must correspond to the publisher of your extension.

Creating a namespace does _not_ automatically give you the exclusive publishing rights. Initially, everyone will be able to publish an extension with the new namespace. If you want exclusive publishing rights, you can claim ownership of a namespace.

$3

You can use ovsx for downloading extensions from an Open VSX instance. Extensions are identified with the format namespace.extension, and an exact version or version range can be specified with the --versionRange (or -v) argument. The namespace corresponds to the publisher entry of the package.json file.

Variants:
* ovsx get
downloads an extension and saves it to a file as specified in its download URL in the current working directory. This is usually in the format namespace.extension-version.vsix. For target platform specific extensions (e.g. linux-x64) the format is namespace.extension-version@target.vsix.
* ovsx get -o
downloads an extension and saves it in the specified file or directory.
* ovsx get --metadata
downloads the JSON metadata of an extension and prints it to the standard output.
* ovsx get --metadata -o
downloads the JSON metadata of an extension and saves it in the specified file or directory.

$3

The login command lets you store an access token for a namespace.

* ovsx login
the name must correspond to the publisher of your extension. ovsx will ask you to provide an access token.

The logout command lets you remove a stored access token.

* ovsx logout
the name must correspond to the publisher of your extension.

By default ovsx will try to use a keytar store with a plaintext file store as fallback. You can specify the environment variable OVSX_STORE=file` to use the file store.