Versioning

Both sessions and plans support versioning. The URL stays the same — each push creates a new version at the same nanoid.

Sessions

Every time you push the same session (same local session ID), a new version is created. Viewers see the latest version by default, with access to specific versions via:

https://rockstar.ninja/s/{nanoid}/{version}

You can delete individual versions:

DELETE /api/v1/sessions/{nanoid}/versions/{version}

Plans

Plans are versioned the same way, with one optimization: if the content hasn't changed since the last push, no new version is created. This means you can safely re-push plans without generating unnecessary versions.

Version history

Plans have a dedicated history page:

https://rockstar.ninja/p/{nanoid}/history

This shows all versions with their creation timestamps.

Plan version historyPlan version history

Diffs

You can view a diff between any two plan versions:

https://rockstar.ninja/p/{nanoid}/diff/1..3

Diffs are rendered with syntax-highlighted additions (green) and removals (red), with word-level highlighting for fine-grained changes.

Raw markdown

Access the raw markdown of any plan version:

https://rockstar.ninja/p/{nanoid}/{version}/{filename}