Take the guided tour

tovio quickstart is an interactive tutorial. It is the fastest way to build the mental model, and it is worth ten minutes even if you know Git well.

tovio quickstart

It uses a throwaway repository

Quickstart creates its own scratch repository and removes it when you exit. It does not touch your work, and you do not need to be inside a repository to run it. If you want to poke at the result afterwards, keep it:

tovio quickstart --no-cleanup

Pick a topic

Without --topic it starts at basics. The five lessons are:

tovio quickstart --topic basicstovio quickstart --topic branchestovio quickstart --topic conflictstovio quickstart --topic policytovio quickstart --topic agents

• basics — changes, commits, status, undo.
• branches — lanes, switching, landing.
• conflicts — how a conflict object behaves and how to resolve one.
• policy — writing a policy and seeing encryption take effect.
• agents — issuing a capability token and committing under it.

The two worth doing first

conflicts and policy. Conflicts behave differently enough from Git that reading about them is less convincing than watching your tree stay buildable while one is open. Policy is the feature TOVIO exists for, and watching a file become ciphertext at commit time is more instructive than any amount of documentation.

If you would rather not be walked through it

tovio help lists the everyday command set, and tovio help <command> gives the full flags and examples for any one of them. See the in-CLI help article.