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

# versuno prompts projects use

> Set or unset the active project.

```
versuno prompts projects use <id>
```

Persists the active project ID to `.versuno/.temp/project-ref`. The active project is then used by `versuno prompts status` and `versuno prompts assets list` to filter results automatically.

Pass `none` to unset the active project and return to workspace-level scope.

## Arguments

| Argument | Required | Description                       |
| -------- | -------- | --------------------------------- |
| `id`     | Yes      | Project ID, or `"none"` to unset. |

## Options

| Flag            | Description                                                       |
| --------------- | ----------------------------------------------------------------- |
| `--format json` | Output `{"project":"<id>"\|null}` instead of human-readable text. |

## Examples

```bash theme={null}
# Set the active project
versuno prompts projects use proj_abc123
# → Active project set to: proj_abc123

# Unset the active project
versuno prompts projects use none
# → Active project unset.
```

## See also

* [versuno prompts projects list](/cli/projects-list) — find available project IDs
* [versuno prompts projects pull](/cli/projects-pull) — pull all assets in a project