Skip to main content
versuno pull <id>
versuno 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

ArgumentRequiredDescription
idPositionalAsset ID to pull. Omit when using --all.

​
Options

FlagDescription
--allRe-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 jsonPrint 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

# Pull a single asset
versuno pull abc123

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

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

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

​
File format

Each pulled asset is written as a Markdown file with frontmatter: 
---
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