Skip to main content
The Versuno CLI is a developer-first tool for syncing AI assets between your local filesystem and the Versuno cloud. It follows a Git-style workflow: pull assets down, edit them, then push new versions back up.

​
Requirements

​
Installation

bun add -g versuno-cli
Or run without installing: 
bunx versuno-cli <command>

​
Quick start

versuno init           # scaffold .versuno/ in your project
versuno login          # authenticate with your API key
versuno teams list     # list your teams
versuno switch <id>    # set the active workspace
versuno assets list    # browse assets in the active workspace
versuno pull <id>      # pull an asset to disk
versuno push -m "msg"  # push local changes as a new version

​
How it works

versuno init creates a .versuno/ directory in your project root: 
.versuno/
  contexts/
  prompts/
  personas/
  system-prompts/
  skills/
  projects/
  .temp/          ← ephemeral state (gitignored)
  .gitignore
Each asset is stored as a Markdown file with YAML frontmatter: 
---
id: abc123
type: prompt
title: My prompt
version: 3
tags: [customer-support]
created_at: 2026-01-01T00:00:00Z
updated_at: 2026-04-01T12:00:00Z
---

You are a helpful assistant...
The CLI tracks content hashes so only modified files are pushed or flagged as changed.

​
Environment variables

VariableDescription
VERSUNO_API_KEYAPI key — overrides stored credentials
VERSUNO_WORKSPACEActive workspace ID — overrides the stored workspace ref
VERSUNO_DEBUGSet to any value to enable verbose error output