Skip to main content
versuno log [file|id] [--limit <n>]
Fetches and prints the version history for an asset. Without arguments it shows recent history for every locally tracked asset. The file argument accepts either a local file path or an asset ID directly (anything without a / or .md extension is treated as an ID).

Arguments

ArgumentRequiredDescription
fileNoLocal file path or asset ID. Omit to show history for all tracked assets.

Options

FlagDescription
--limit <n>Number of versions per asset (default: 5, max: 50).
--format jsonOutput raw JSON.

Examples

# History for a specific local file
versuno log prompts/intro.md

# History by asset ID
versuno log ctx_abc123

# Show 20 versions
versuno log prompts/intro.md --limit 20

# History for all tracked assets
versuno log

# JSON output
versuno log ctx_abc123 --format json

Output

My Intro Prompt  (prm_abc123)

 version | date             | author   | description
---------|------------------|----------|--------------------
 v5      | 2026-04-01 12:00 | alice    | Improved tone
 v4      | 2026-03-28 09:15 | bob      | Fix grammar
 v3      | 2026-03-20 11:30 | alice    |

See also