🍺 tavern Version control for worlds too big for Git DocsSign in

Quickstart

From zero to your first push in a few minutes.

1Sign in #

Go to tavern.xyz and sign in with GitHub. Your account is created on first sign-in.

2Create a repository #

Click New, give it a name, and create it. Repositories are private by default. Uncheck the box if you'd rather make it public.

Or create it straight from the CLI (after step 4) · the repository is registered to your account, private by default:

lore repository create grpcs://lore.tavern.xyz/<you>/<repo>

The name must live under your own namespace (<you>/…) and follow the same naming rules as the web form.

3Install the lore CLI #

Install Epic's open-source lore client:

curl -fsSL https://raw.githubusercontent.com/EpicGames/lore/main/scripts/install.sh | bash

Or download a binary from the lore releases page. See the lore docs for platform details.

4Authenticate the CLI #

Point lore login at your clone host and it opens your browser to approve the sign-in — no token to copy or expire. Approve as yourself, then return to the terminal:

lore login grpcs://lore.tavern.xyz

Prefer a token (CI, headless)? Generate one in Settings and run lore login --token-type lore --token <YOUR_TOKEN> --auth-url https://auth.tavern.xyz — or add --no-browser to the command above to print the approval link instead of opening a browser.

5Push your first commit #

lore clone grpcs://lore.tavern.xyz/<you>/<repo>
cd <repo>
echo "# my world" > README.md
lore stage --scan .
lore commit "first commit"
lore push

Refresh the repo page on the web and your files are there.

Tip lore stage on its own only stages files already marked dirty. Use lore stage --scan . to discover and stage everything you've changed on disk.