Reference

CLI reference

Every land command and its options.

Every command takes --help for its options and examples. Errors print the exact command that fixes them.

land login

Connect this machine to your land account by signing in with GitHub.

--no-wait
Print a link and a code and return at once. Finish with land login or --paste.
--paste CODE
On a remote machine, paste the code the approval page shows.
--logout
Forget this machine's key. Safe to run twice.
--json
Output a program can read.
land login
land login --paste K7QF-2MXD

land status

Who this machine is signed in as, this month's usage, recent merges and a link to your dashboard.

--json
Output a program can read.
land status

land add

Connect the repository to land, once. It uploads the committed files of the default branch only, never history, uncommitted or untracked files, and records which tests already fail. Running it again is safe.

--dry-run
Upload nothing. Print the files and bytes that would go, the test command and what is never sent.
--test CMD
The command that runs your tests. Repeat it as --test NAME=CMD for several named commands.
--allow-test-edits
Let merges change test files. Refused by default.
--allow-low-guard
Accept a repository whose tests guard little. Refused by default.
--json
Output a program can read.
land add --dry-run --test 'python -m pytest -q'
land add --test 'python -m pytest -q'

land merge

Merge branches onto your origin copy of a target, run the tests once, and print the verdict. Run git fetch first. It waits up to 60 seconds, and if land is still working, running the same command again is the wait.

--onto BRANCH
The target branch. Required.
--result tree
Don't build a local commit, print the proven tree instead.
--json
One JSON object on stdout, progress on stderr.
land merge sub/api sub/ledger --onto main --json

land verify

Check offline that a commit or tree was proven by land. Exits 0 when it was and 1 with the reason when it wasn't.

--pubkey FILE
land's public keys, saved from the API.
--protected BRANCH
The branch the commit must have been proven for.
land verify HEAD --pubkey land-keys.json --protected main

Environment variables

LAND_TOKEN
A token from your dashboard. Replaces land login, for CI and cloud agents.
LAND_API
Another land server, https only. Mostly for testing.