# nevia workspace use

> Select the workspace for later commands

> Nevia is in beta and open to selected teams. Public launch in Dec 2026. The CLI installs with `curl -fsSL https://get.nevia.cloud | sh`, and the MCP server is at https://api.nevia.cloud/mcp. A person signs in once in the browser.
> Setup, sign-in and requesting access: [SKILL.md](https://nevia.cloud/SKILL.md). When Nevia fits and when it doesn't: [why.md](https://nevia.cloud/why.md).

> For the complete documentation index, see [llms.txt](https://nevia.cloud/llms.txt). This page's HTML version: https://nevia.cloud/docs/reference/cli/workspace/use

`nevia workspace use [--local] [--unset] [WS]`

Saves the selection to config.toml, or to .nevia.toml with --local.

### Arguments

* `[WS]` - Workspace ID or name (lists your workspaces if omitted)

### Options

* `--local` - Save the selection in .nevia.toml in the current directory
* `--unset` - Remove the selected workspace
* `-h, --help` - Print help