Basic Usage

jnc covers the full lifecycle of workspace management. Here’s an overview of the most common workflows.

Managing workspaces

Command	Description
`jnc init`	Create a new workspace
`jnc add`	Add a dependency
`jnc remove`	Remove a dependency
`jnc update`	Update dependencies in the lock file
`jnc upgrade`	Upgrade dependencies with loosened version constraints
`jnc lock`	Solve and update the lock file without installing
`jnc install`	Install the environment from the lock file
`jnc info`	Show workspace and system information
`jnc run`	Run a task or command in the environment
`jnc shell`	Start an interactive shell in the environment
`jnc list`	List packages in the environment
`jnc tree`	Show a dependency tree
`jnc clean`	Remove the environment

jnc can install tools globally in isolated environments, accessible from anywhere:

Command	Description
`jnc global install`	Install a package into its own global environment
`jnc global uninstall`	Remove a global environment
`jnc global add`	Add a package to an existing global environment
`jnc global list`	List global environments
`jnc global sync`	Sync global environments with the global manifest
`jnc global update`	Update global environments

More information: Global Tools

Run a command in a temporary environment without creating a workspace:

jnc exec python -- -c "print('hello')"
jnc exec --spec "python=3.12" python -- -VV

Define cross-platform tasks in your manifest:

[tasks]
build = "make build"

[tasks.test]
cmd = "pytest"
depends-on = ["build"]

Run them with jnc run build or jnc run test. Tasks can depend on other tasks and run in the correct order. More information: Tasks

Workspaces support multiple environments built from features:

jnc add --feature test pytest     # Add to "test" feature
jnc run --environment test pytest # Run in "test" environment

More information: Environments

jnc targets linux-aarch64 for NVIDIA Jetson (JetPack 6) devices:

jnc add python --platform linux-aarch64

Command	Description
`jnc info`	Show workspace and system information
`jnc config`	View or edit configuration
`jnc tree`	Show dependency tree
`jnc list`	List installed packages
`jnc clean`	Remove workspace environments
`jnc auth`	Manage conda channel authentication
`jnc search`	Search for packages
`jnc completion`	Generate shell completion scripts
`jnc probe`	Detect NVIDIA Jetson hardware