> ## 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 pull

> Download an asset from the cloud and write it to disk.

```
versuno prompts pull <id>
versuno prompts pull --all [--project <slug>]
```

Fetches one or more assets from the Versuno API and writes them as Markdown files with YAML frontmatter into the appropriate `.versuno/` subdirectory. The CLI computes a content hash before and after writing so unchanged files are skipped.

Output mirrors Git's compact diff summary (e.g. `prompts/my-prompt.md | 3 +++`).

## Arguments

| Argument | Required   | Description                                |
| -------- | ---------- | ------------------------------------------ |
| `id`     | Positional | Asset ID to pull. Omit when using `--all`. |

## Options

| Flag               | Description                                                                    |
| ------------------ | ------------------------------------------------------------------------------ |
| `--all`            | Re-pull every locally tracked asset (re-reads all frontmatter `id` fields).    |
| `--project <slug>` | Write files into `.versuno/projects/<slug>/` instead of the type-level folder. |
| `--format json`    | Print a JSON summary of what was pulled instead of the human-readable output.  |

## Output

```
Workspace: personal

 prompts/my-prompt.md          |  5 +++++
 contexts/onboarding-guide.md  |  2 +-
───────────────────────────────────────────
 2 files changed, 6 insertions(+), 1 deletion(-)
```

## Examples

```bash theme={null}
# Pull a single asset
versuno prompts pull abc123

# Re-pull all locally tracked assets
versuno prompts pull --all

# Pull into a project subfolder
versuno prompts pull abc123 --project my-project

# JSON output (useful for scripts)
versuno prompts pull --all --format json
```

## File format

Each pulled asset is written as a Markdown file with frontmatter:

```md theme={null}
---
id: abc123
type: prompt
title: My Prompt
version: 5
tags: [onboarding]
created_at: 2026-01-01T00:00:00Z
updated_at: 2026-04-01T12:34:00Z
---

Asset content goes here...
```

## See also

* [versuno prompts push](/cli/push) — push local changes back to the cloud
* [versuno prompts status](/cli/status) — see which files have been modified