Commands

Project setup

qv init

Create a new nupackage.toml in the current directory and scaffold the initial module and environment files.

qv init --name my-module --version 0.1.0 --nu-version 0.110.0

Supported flags:

• --name
• --version
• --nu-version
• --description

qv add

Add a module dependency from a git URL or shorthand.

qv add owner/repo --tag v1.2.3
qv add https://git.example.com/team/mod --branch main

Supported flags:

• -g, --global
• --tag
• --rev
• --branch

qv add-plugin

Add a plugin dependency from git or a supported Nushell core plugin alias.

qv add-plugin nushell/nu_plugin_inc --tag v0.91.0 --bin nu_plugin_inc
qv add-plugin polars

Supported flags:

• --tag
• --rev
• --branch
• --bin

qv remove

Remove a dependency from the project manifest or the global config.

qv remove nu-salesforce
qv rm nu-salesforce
qv remove -g nu-utils

Install and update

qv install

Install project dependencies from nupackage.toml.

qv install
qv install --frozen
qv install --allow-unsigned
qv install --no-build-fallback

Supported flags:

• -g, --global
• --frozen
• --allow-unsigned
• --no-build-fallback

--frozen uses the lockfile only and fails if it is missing or stale.

qv update

Discard the current local lockfile and resolve again.

qv update

Working in the environment

qv run

Run a command inside the current project environment.

qv run nu
qv run nu script.nu --flag

qv hook

Print the Nushell hook used for directory-based auto-activation.

qv hook

qv lsp

Generate editor configuration for Nushell language server support.

qv lsp
qv lsp --editor helix --editor zed

Informational commands

qv list

List installed dependencies. In a project directory it shows project-local dependencies. Without a local manifest, it falls back to global modules.

qv list
qv ls

qv version

Print the Quiver version.

qv version
qv --version
qv -v