CLI Reference
jnc provides a comprehensive set of commands for managing workspaces, dependencies, environments, and tasks.Global Options
These options are available on every command:| Option | Description |
|---|---|
-h, --help | Display help information |
-v, --verbose | Increase logging verbosity (-v warnings, -vv info, -vvv debug, -vvvv trace) |
-q, --quiet | Decrease logging verbosity (quiet mode) |
--color <auto|always|never> | Control colored output (default: auto) |
--no-progress | Hide all progress bars |
Commands
Workspace Management
| Command | Alias | Description |
|---|---|---|
jnc init | Create a new workspace | |
jnc install | i | Install an environment, updating the lockfile if needed |
jnc reinstall | Re-install an environment with optional package filtering | |
jnc lock | Solve the environment and update the lock file without installing | |
jnc import | Import an environment from a conda environment.yml file | |
jnc info | Show workspace and system information | |
jnc clean | Remove workspace environments and caches |
Dependencies
| Command | Alias | Description |
|---|---|---|
jnc add | a | Add dependencies to the workspace |
jnc remove | rm | Remove dependencies from the workspace |
jnc update | Update dependencies in the lock file | |
jnc upgrade | Upgrade dependencies with loosened version constraints | |
jnc list | ls | List packages installed in the environment |
jnc tree | t | Show a dependency tree |
jnc search | Search for packages in configured channels |
Tasks and Execution
Shell
| Command | Alias | Description |
|---|---|---|
jnc shell | s | Start an interactive shell in the environment |
jnc shell-hook | Print the environment activation script |
Global Tools
| Command | Alias | Description |
|---|---|---|
jnc global | g | Manage globally installed tools in isolated environments |
Workspace Configuration
| Command | Description |
|---|---|
jnc workspace | Manage workspace settings (platforms, channels, environments, features) |
jnc config | View or edit jnc configuration |
jnc auth | Manage conda channel authentication |
Build and Publish
| Command | Description |
|---|---|
jnc build | Build a conda package from the workspace |
jnc upload | Upload a package to a channel |
Utilities
| Command | Description |
|---|---|
jnc completion | Generate shell completion scripts |
jnc probe | Detect hardware capabilities (e.g., NVIDIA Jetson) |
Update Options
Several commands support options that control how the lock file and environment are updated:| Option | Description |
|---|---|
--frozen | Use the lockfile as-is, do not update it even if the manifest has changed |
--locked | Require the lockfile to be up-to-date with the manifest, abort if not |
--no-install | Only modify the lock file, do not install the environment |
--as-is | Shorthand for --frozen --no-install (available on run, shell, shell-hook) |