---
title: pixi workspace register
---
<!--- This file is autogenerated. Do not edit manually! -->
# [pixi](../../pixi.md) [workspace](../workspace.md) register

Commands to manage the registry of workspaces. Default command will add a new workspace

--8<-- "docs/reference/cli/pixi/workspace/register_extender:description"

## Usage
```
pixi workspace register [OPTIONS] [COMMAND]
```

## Subcommands
| Command | Description |
|---------|-------------|
| [`list`](register/list.md) | List the registered workspaces |
| [`remove`](register/remove.md) | Remove a workspace from registry |
| [`prune`](register/prune.md) | Prune disassociated workspaces from registry |


## Options
- <a id="arg---name" href="#arg---name">`--name (-n) <NAME>`</a>
:  Name of the workspace to register. Defaults to the name of the current workspace
- <a id="arg---path" href="#arg---path">`--path (-p) <PATH>`</a>
:  Path to register. Defaults to the path to the current workspace
- <a id="arg---force" href="#arg---force">`--force (-f)`</a>
:  Overwrite the workspace entry if the name of the workspace already exists in the registry

## Global Options
- <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path (-m) <MANIFEST_PATH>`</a>
:  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
- <a id="arg---workspace" href="#arg---workspace">`--workspace (-w) <WORKSPACE>`</a>
:  Name of the workspace

--8<-- "docs/reference/cli/pixi/workspace/register_extender:example"
