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

# Manage workspaces

> Create, select, inspect, and remove local workspace entries.

# Manage workspaces

## What this does

These commands create a remote workspace and manage the client's local workspace list.

## Before you begin

Install the client and sign in. Account setup normally creates and selects your first workspace.

## Steps

1. Create a named workspace.

   ```bash theme={"theme":"vesper"}
   agentsfleet workspace create platform-ops
   ```

   ```text theme={"theme":"vesper"}
   Workspace added
   workspace_id: <varies>
   name: platform-ops
   ```

2. List local workspace entries.

   ```bash theme={"theme":"vesper"}
   agentsfleet workspace list
   ```

   ```text theme={"theme":"vesper"}
   ACTIVE    WORKSPACE                               NAME
   *         <varies>                                platform-ops
   ```

3. Select a workspace.

   `<WORKSPACE_ID>` comes from the list output.

   ```bash theme={"theme":"vesper"}
   agentsfleet workspace use <WORKSPACE_ID>
   ```

   ```text theme={"theme":"vesper"}
   ✓ active workspace: <varies>
   ```

## Verify it works

```bash theme={"theme":"vesper"}
agentsfleet workspace show
```

```text theme={"theme":"vesper"}
Workspace
workspace_id: <varies>
active: yes
name: <varies>
```

## Common problems

An unknown workspace identifier is rejected because it is absent from local state. Run `workspace list` before `workspace use`.

The dashboard and client keep separate active-workspace choices. Changing one does not change the other.

## Remove or undo

This command removes the workspace only from local client state. It does not delete remote fleets, secrets, events, or the workspace record.

`<WORKSPACE_ID>` comes from `agentsfleet workspace list`.

```bash theme={"theme":"vesper"}
agentsfleet workspace delete <WORKSPACE_ID>
```

```text theme={"theme":"vesper"}
✓ workspace removed from local state: <varies>
```

## Related pages

* [Workspace overview](/workspaces/overview)
* [Client configuration](/cli/configuration)
* [Quickstart](/quickstart)