Skip to main content

jnc shell

Starts an interactive shell session with the workspace environment activated. All packages installed in the environment are available on the PATH, and environment variables are set as if the environment were natively active. The shell type is detected automatically from your current process (bash, zsh, fish). Run exit to leave the shell and return to your original environment. The environment is automatically installed and updated before the shell starts, unless --frozen or --as-is is used. Alias: s

Usage

jnc shell [OPTIONS]

Options

OptionDescription
-e, --environment <ENV>The environment to activate in the shell. Defaults to default.

Update Options

OptionDescription
--frozenUse the lockfile as-is, do not update it.
--lockedRequire the lockfile to be up-to-date, abort if not.
--no-installDo not install the environment before starting the shell.
--as-isShorthand for --frozen --no-install.

Global Options

OptionDescription
-m, --manifest-path <PATH>Path to pixi.toml, pyproject.toml, or the workspace directory.

Examples

Start a shell in the default environment

jnc shell

Start a shell in a specific environment

jnc shell --environment cuda

Start a shell without updating the lock file

jnc shell --frozen

Start a shell without any updates or installs

jnc shell --as-is