---
url: https://docs.mochiexec.io/reference/cli/mochi_workspace.md
description: Manage development workspaces.
---

# mochi workspace

Manage development workspaces.

## Synopsis

Manage flow workspaces. A workspace is a directory (local or git-sourced) that contains
flow files defining your executables. One workspace is active at a time.

Workspaces are registered globally so flow can find executables across projects.
Use 'workspace add' to register a new workspace, 'workspace switch' to change the
active workspace, and 'workspace update' to pull the latest changes from a remote source.

## Options

| Flag | Type | Description |
|------|------|-------------|
| `-h, --help` |  | help for workspace |

## Options inherited from parent commands

| Flag | Type | Description |
|------|------|-------------|
| `-L, --log-level` | `string` | Log verbosity level (debug, info, fatal) (default "info") |
| `--sync` |  | Sync flow cache and workspaces |

## See also

* [mochi](mochi.md) — Run and organize your development tasks
* [mochi workspace add](mochi_workspace_add.md) — Initialize a new workspace from a local path or Git URL.
* [mochi workspace edit](mochi_workspace_edit.md) — Edit a workspace's display name, description, or tags
* [mochi workspace get](mochi_workspace_get.md) — Get workspace details. If the name is omitted, the current workspace is used.
* [mochi workspace list](mochi_workspace_list.md) — List all registered workspaces.
* [mochi workspace remove](mochi_workspace_remove.md) — Remove an existing workspace.
* [mochi workspace switch](mochi_workspace_switch.md) — Switch the current workspace.
* [mochi workspace update](mochi_workspace_update.md) — Pull latest changes for a git-sourced workspace.