> ## Documentation Index
> Fetch the complete documentation index at: https://jncpkg.org/llms.txt
> Use this file to discover all available pages before exploring further.

# jnc workspace

> Modify workspace configuration including channels, platforms, environments, and more.

# jnc workspace

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

**Alias:** `jnc project`

## Usage

```bash theme={null}
jnc workspace <SUBCOMMAND>
```

## Subcommands

### `channel`

Manage conda channels for the workspace.

```bash theme={null}
jnc workspace channel add <CHANNEL>...
jnc workspace channel list
jnc workspace channel remove <CHANNEL>...
```

### `description`

Get or set the workspace description.

```bash theme={null}
jnc workspace description get
jnc workspace description set <DESCRIPTION>
```

### `platform`

Manage target platforms for the workspace.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
jnc workspace environment add <NAME> [OPTIONS]
jnc workspace environment list
jnc workspace environment remove <NAME>
```

### `feature`

Manage features in the workspace.

```bash theme={null}
jnc workspace feature list
jnc workspace feature remove <NAME>
```

### `export`

Export the workspace environment to other formats.

```bash theme={null}
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.

```bash theme={null}
jnc workspace name get
jnc workspace name set <NAME>
```

### `system-requirements`

Manage system requirements for the workspace.

```bash theme={null}
jnc workspace system-requirements add <REQUIREMENT>
jnc workspace system-requirements list
```

## Global Options

| Option            | Short | Description                            |
| ----------------- | ----- | -------------------------------------- |
| `--manifest-path` | `-m`  | Path to `jnc.toml` or `pyproject.toml` |

## Examples

```bash theme={null}
# 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
```