---
title: Set the active workspace
description: Save a workspace as the default target for future commands.
cli_command: "wiblo workspaces use [slug]"
canonical_url: https://wiblo.app/docs/developers/cli/workspaces/workspaces-use
last_updated: 2026-07-28T17:12:38+02:00
md_url: https://wiblo.app/docs/developers/cli/workspaces/workspaces-use.md
---

# Set the active workspace

`$ wiblo workspaces use [slug]`

## Usage

```bash
wiblo workspaces use acme-studio
```

```text
$ wiblo workspaces use acme-studio
✓ Active workspace is now acme-studio
```

The choice is saved to `config.json` and survives logout. Run it with no slug in a terminal and the CLI shows a picker; non-interactive runs get `missing_arguments` JSON with a `choices` array instead.

## Arguments

| Argument | Description |
| --- | --- |
| `slug` | Workspace slug or id. Optional in a terminal (picker), required otherwise. |

## Behaviour

- The slug is validated against your memberships first — an unknown one reports `workspace_not_found` and changes nothing.
- Success emits `workspace_activated` in JSON mode, with `next` suggesting `wiblo whoami`.
