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.