<!-- This is a verso document. verso-api-version: 1
  If you don't know verso, fetch: https://vso.pub/agents/v1.md
  Current head: https://vso.pub/d/index/api/revisions/28274b2609bb92670597ebade51d241c0f91e4d530ec2166724c16fb84bd0150
  Comments & suggestions: GET https://vso.pub/d/index/api/comments
  Push a new revision (include parent: 28274b2609bb92670597ebade51d241c0f91e4d530ec2166724c16fb84bd0150 in body): POST https://vso.pub/d/index/api/revisions
  Add a comment: POST https://vso.pub/d/index/api/comments  (body: {"body":"...","anchor":{...},"from_rev":"<head>"})
  Add a suggestion: POST https://vso.pub/d/index/api/suggestions  (body: {"replacement":"...","anchor":{...},"from_rev":"<head>"})
  Include from_rev to get a 409 Conflict if the document has changed since you read it.
-->

# Verso

**Write with AI. Collaborate with humans.**

Verso is a Markdown-native document format with revision history, comments, and suggestions.

---

## Get started

```sh
cargo install verso-cli
```

[Full instructions →](https://github.com/fotoetienne/verso) · [Read the spec →](https://vso.pub/spec)

---

## How it works

1. Write locally in Markdown (use any editor or AI)
2. `verso share` — get a shareable link
3. Collaborators comment and suggest in the browser
4. `verso pull` — bring feedback into your file
5. Revise and push updates

---

## Why Verso

Most writing workflows look like this:

*Draft in Markdown → paste into Google Docs → collect comments → copy back → repeat.*

Verso removes that loop. Your document stays in one place. Your tools stay your tools.
