Skip to main content

​
jnc workspace

Modifies workspace configuration stored in pixi.toml. This command provides subcommands for managing channels, platforms, environments, features, versioning, and other workspace settings. Alias: jnc project

​
Usage

jnc workspace <SUBCOMMAND>

​
Subcommands

​
channel

Manage conda channels for the workspace. 
jnc workspace channel add <CHANNEL>...
jnc workspace channel list
jnc workspace channel remove <CHANNEL>...

​
description

Get or set the workspace description. 
jnc workspace description get
jnc workspace description set <DESCRIPTION>

​
platform

Manage target platforms for the workspace. 
jnc workspace platform add <PLATFORM>...
jnc workspace platform list
jnc workspace platform remove <PLATFORM>...
Platform: linux-aarch64 (Jetson). Additional platforms will be supported in the future.

​
version

Manage the workspace version. 
jnc workspace version get
jnc workspace version set <VERSION>
jnc workspace version major    # Bump major version
jnc workspace version minor    # Bump minor version
jnc workspace version patch    # Bump patch version

​
environment

Manage environments in the workspace. 
jnc workspace environment add <NAME> [OPTIONS]
jnc workspace environment list
jnc workspace environment remove <NAME>

​
feature

Manage features in the workspace. 
jnc workspace feature list
jnc workspace feature remove <NAME>

​
export

Export the workspace environment to other formats. 
jnc workspace export conda-environment [OPTIONS]
jnc workspace export conda-explicit-spec [OPTIONS]
These commands produce output compatible with conda’s environment and explicit specification formats, making it easy to share environments with users of other conda tools.

​
name

Get or set the workspace name. 
jnc workspace name get
jnc workspace name set <NAME>

​
system-requirements

Manage system requirements for the workspace. 
jnc workspace system-requirements add <REQUIREMENT>
jnc workspace system-requirements list

​
Global Options

OptionShortDescription
--manifest-path-mPath to pixi.toml or pyproject.toml

​
Examples

# Add conda-forge and pytorch channels
jnc workspace channel add conda-forge pytorch

# List configured channels
jnc workspace channel list

# Remove a channel
jnc workspace channel remove pytorch

# Add target platforms
jnc workspace platform add linux-aarch64

# List target platforms
jnc workspace platform list

# Set the workspace description
jnc workspace description set "My data science workspace"

# Set the workspace version
jnc workspace version set 1.0.0

# Bump the patch version (1.0.0 -> 1.0.1)
jnc workspace version patch

# Add a new environment with features
jnc workspace environment add test

# List environments
jnc workspace environment list

# Remove an environment
jnc workspace environment remove test

# List features
jnc workspace feature list

# Export as a conda environment file
jnc workspace export conda-environment

# Export as a conda explicit spec
jnc workspace export conda-explicit-spec

# Get the workspace name
jnc workspace name get

# Set the workspace name
jnc workspace name set my-project

# Add a system requirement
jnc workspace system-requirements add "cuda>=12.0"

# List system requirements
jnc workspace system-requirements list

# Use the project alias
jnc project channel list