---
title: "Spaces & Projects in the CLI"
canonical: https://trickest.com/docs/developer-tools/cli/spaces
description: "Organize your work with spaces and projects from the CLI: list, create, rename, update, and delete."
---

# Spaces & Projects in the CLI

<Info>
**Platform concepts:** [Workspaces & Projects](/docs/key-concepts/workspaces-and-projects).
This page covers the **`trickest space`** and **`trickest projects`** commands only.
</Info>

**Spaces** are the top-level containers that hold your workflows. **Projects** are
optional sub-groupings inside a space.

<Note>
Output is JSON by default. `space ls` and `projects ls` return **bare JSON arrays**.
Add `--output table` for a human view.
</Note>

## `trickest space`

Manage spaces.

| Subcommand | Description |
|---|---|
| `space ls` | List all spaces |
| `space info\|get <name-or-id>` | Get space details |
| `space create\|new <name>` | Create a space |
| `space rename <name-or-id> <new-name>` | Rename a space |
| `space update <name-or-id>` | Update space metadata |
| `space rm\|delete <name-or-id>` | Delete a space |

### `space ls`

```bash
trickest space ls
```
```json
[{"name":"Solutions","id":"5c57db3d-…","description":"…","created":"2025-12-29T16:10:55Z"},
 {"name":"Demo","id":"e7fd1cb3-…","description":"","created":"2026-05-13T10:38:40Z"}]
```

Options:

| Flag | Description |
|---|---|
| `--filter <query>` | Filter spaces by name substring |
| `--fields <fields>` | Comma-separated fields to include (e.g. `name,id`) |

```bash
trickest space ls --filter sol --fields name,id
trickest --output table space ls
```

### `space info`

Get a single space by name or ID (`get` is an alias):

```bash
trickest space info Solutions
trickest space get 5c57db3d-…
```

### `space create`

```bash
trickest space create "Red Team" --description "Offensive discovery workflows"
```

| Flag | Description |
|---|---|
| `--description <desc>` | Space description |

### `space rename` / `space update`

```bash
trickest space rename "Red Team" "Red Team 2026"
trickest space update "Red Team 2026" --description "Updated description"
```

### `space rm`

```bash
trickest space rm "Old Space" --force
```

| Flag | Description |
|---|---|
| `--force` | Skip the confirmation prompt |

<Warning>
Deleting a space removes the workflows inside it. Use `--force` only when you're sure.
</Warning>

## `trickest projects`

Manage projects within a space. Unlike workflow commands, **`projects` does not use
your active context** — you must tell it which space to operate on.

| Subcommand | Description |
|---|---|
| `projects ls [space-id]` | List projects in a space |
| `projects get <id>` | Get project details |
| `projects create <name>` | Create a project |
| `projects update <id>` | Update a project |
| `projects rm <id>` | Delete a project |

### `projects ls`

You must provide a space, either positionally or with `--space`:

```bash
trickest projects ls 5c57db3d-…
trickest projects ls --space 5c57db3d-…
```
```json
[]
```

<Warning>
Running `trickest projects ls` with **no space** fails with `ERR_VALIDATION` (exit
code 4) — the API requires a `spaceId`. Always pass the space.
</Warning>

### `projects create` / `update` / `rm`

```bash
trickest projects create "Discovery" --space 5c57db3d-… --description "Discovery pipelines"
trickest projects update <project-id> --name "Discovery 2026"
trickest projects rm <project-id>
```

| Command | Notable flags |
|---|---|
| `projects create` | `--space <id>`, `--description <desc>` |
| `projects update` | `--name <name>`, `--description <desc>` |

## Recipe: set up a workspace

```bash
trickest space create "Red Team" --description "Offensive discovery"
SPACE_ID=$(trickest space info "Red Team" | jq -r '.id')
trickest projects create "Discovery" --space "$SPACE_ID"
trickest switch /spaces/"Red Team"/workflows/whatever   # once you create a workflow
```

## Related

<CardGroup cols={2}>
  <Card title="Workflows" icon="diagram-project" href="/docs/developer-tools/cli/workflows">
    Create and manage the workflows that live inside a space.
  </Card>
  <Card title="Configuration & Context" icon="gear" href="/docs/developer-tools/cli/configuration">
    Set your active space so workflow commands know where to look.
  </Card>
</CardGroup>

---
_Markdown source of https://trickest.com/docs/developer-tools/cli/spaces._