CLI reference
Every envden command with its arguments and options.
This page is generated from the CLI's own help text; run bun run docs:cli in the repository to regenerate it. Every command also accepts -h, --help.
envden agent
Install the envden agent skill.
envden agent [options] [command]Subcommands: install.
envden agent install
Install or refresh the agent skill.
envden agent install [options]envden alias
Share another repo's env files, for example from a fork.
envden alias [options] <repo> <target>| Argument | Description |
|---|---|
<repo> | Repo ID to alias |
<target> | Repo ID whose env files it uses |
envden config
Read or change settings.
envden config [options] [key] [values...]| Argument | Description |
|---|---|
[key] | telemetry, update-check, agent-merge, auto-approve-worktrees, unlock-period, placement or env-files |
[values...] | New value; placement takes a checkout path and link or copy |
envden device
Add, list, rename and remove devices.
envden device [options] [command]Subcommands: add, ls, rename, rm.
envden device add
Show a pairing code for a new device.
envden device add [options]envden device ls
List devices and the version each last used.
envden device ls [options]| Option | Description |
|---|---|
--json | Print the result as JSON |
--verbose | Include device ids |
envden device rename
Rename this device.
envden device rename [options] <name>| Argument | Description |
|---|---|
<name> | New name, unique in the vault |
envden device rm
Remove a device and re-key the vault so it can't read new changes.
envden device rm [options] <device>| Argument | Description |
|---|---|
<device> | Device name or ID |
| Option | Description |
|---|---|
--kit-out <file> | Write the new recovery kit as JSON to a private file instead of a PDF |
--new-kit | Also replace the recovery kit as part of the removal |
envden diff
Show changed key names without values.
envden diff [options]| Option | Description |
|---|---|
--json | Print the result as JSON |
--all | Include all repos |
envden doctor
Check key files, symlinks, updates, Tailscale, HTTPS and shell notices.
envden doctor [options]| Option | Description |
|---|---|
--json | Print the report as JSON |
envden history
List the versions the server keeps, or restore one as a local edit.
envden history [options] [file]| Argument | Description |
|---|---|
[file] | Env file path |
| Option | Description |
|---|---|
--all | Include every tracked file |
--restore <version> | Write that version into the checkout without pushing |
--yes | Confirm the restore |
--json | Print the result as JSON |
envden join
Join using a pairing code or recovery kit in your own terminal.
envden join [options] <server>| Argument | Description |
|---|---|
<server> | Server address, e.g. envden.your-tailnet.ts.net |
| Option | Description |
|---|---|
--recovery | Paste a recovery secret key and vault ID |
--recovery-kit <path> | Recovery kit path |
--name <name> | Device name |
--yes | Use default preferences |
--telemetry <choice> | Anonymous telemetry (on, off) |
--update-check <choice> | Daily update check (on, off) |
--shell <shell> | Shell notice (zsh, bash, fish, powershell, none) |
--agent <choice> | Install the agent skill (on, off) |
--resume | Finish a join that was approved while this command wasn't running |
envden local-only
Keep a managed file local to this checkout.
envden local-only [options] <file>| Argument | Description |
|---|---|
<file> | Managed env file in this checkout |
envden pull
Fetch and merge changes from your other devices.
envden pull [options]| Option | Description |
|---|---|
--json | Print the result as JSON |
--all | Sync all repos |
--yes | Confirm clean changes |
envden push
Send your changes to the server.
envden push [options]| Option | Description |
|---|---|
--json | Print the result as JSON |
--all | Sync all repos |
--yes | Confirm clean changes |
envden resolve
Keep yours, take the server's, or finish an edited conflict.
envden resolve [options] [file]| Argument | Description |
|---|---|
[file] | Conflicted env file |
| Option | Description |
|---|---|
--json | Print the result as JSON |
--list | List unresolved conflicts |
--repo <path> | Select a checkout |
--keep-mine | Keep your version |
--take-server | Take the server's version |
envden rm
Remove an env file everywhere on the next push.
envden rm [options] <path>| Argument | Description |
|---|---|
<path> | Env file path |
| Option | Description |
|---|---|
--yes | Confirm deletion, including local edits and conflicts |
--json | Print the result as JSON |
envden serve
Run the server; ENVDEN_SETUP_TOKEN replaces the setup token.
envden serve [options]| Option | Description |
|---|---|
--restored | Start a restored backup in repair-only mode |
--min-client <version> | Oldest client version to accept |
--data-dir <path> | Server data directory |
--port <port> | Localhost port |
envden server
Move, switch or repair the server.
envden server [options] [command]Subcommands: move, repair, switch.
envden server move
Move the vault to a new server.
envden server move [options] [server]| Argument | Description |
|---|---|
[server] | Destination server address |
| Option | Description |
|---|---|
--setup-token <token> | Setup token, visible to other processes; use the prompt in a terminal |
--resume | Resume an interrupted move |
--abort | Abort an unfinished move |
envden server repair
After a server restore, re-upload this device's data, or finish the restore with --finish.
envden server repair [options]| Option | Description |
|---|---|
--repair-token <token> | Repair token; prefer stdin for upload, use a terminal for --finish |
--finish | Check every device's upload and finish the restore |
--without <device...> | Drop unavailable devices; they rejoin as new devices |
--accept-lost | Accept the newest verified older version of a missing file |
envden server switch
Follow a signed move when the old server is unreachable.
envden server switch [options] <server>| Argument | Description |
|---|---|
<server> | Destination server address |
envden setup
Create a vault and configure this device.
envden setup [options]| Option | Description |
|---|---|
--yes | Take defaults; secrets and checkout approval still require your terminal |
--server <url> | Use this server |
--kit-out <file> | Write the recovery kit as JSON to a private file instead of a PDF |
--name <name> | Device name |
--host-server | Run the envden server on this machine; no setup token needed |
--setup-token <token> | Setup token, visible to other processes; use the prompt in a terminal |
--telemetry <choice> | Anonymous telemetry (on, off) |
--update-check <choice> | Daily update check (on, off) |
--shell <shell> | Shell notice (zsh, bash, fish, powershell, none) |
--agent <choice> | Install the agent skill (on, off) |
--scan-root <path...> | Roots to scan for repos |
--exclude-root <path...> | Roots to skip |
--verbose | List each repo and env file the scan skipped |
envden shell
Manage the shell notice.
envden shell [options] [command]Subcommands: install, uninstall.
envden shell install
Add the out-of-sync notice to your shell config.
envden shell install [options] [shell]| Argument | Description |
|---|---|
[shell] | Shell; asks if omitted (zsh, bash, fish, powershell) |
envden shell uninstall
Remove the out-of-sync notice from your shell config.
envden shell uninstall [options] [shell]| Argument | Description |
|---|---|
[shell] | Shell; asks if omitted (zsh, bash, fish, powershell) |
envden status
Show what changed here, what's newer on the server and what needs attention.
envden status [options]| Option | Description |
|---|---|
--json | Machine-readable status |
envden track
Scan, approve and link checkout env files.
envden track [options] [path]| Argument | Description | Default |
|---|---|---|
[path] | Checkout or scan root | current directory |
| Option | Description |
|---|---|
--copy | Place real copies instead of links |
--verbose | List each repo and env file the scan skipped |
envden ui
Open a local dashboard for this device.
envden ui [options]| Option | Description |
|---|---|
--port <port> | Port on 127.0.0.1 (default: random) |
--no-open | Print the link without opening a browser |
envden unlock
Log in with your master password to restart the unlock period.
envden unlock [options]envden untrack
Stop tracking a checkout and restore regular env files.
envden untrack [options] <path>| Argument | Description |
|---|---|
<path> | Checkout root |
envden update
Update envden through the method it was installed with.
envden update [options]| Option | Description |
|---|---|
--check | Check for a release without installing |
--post-install | Refresh installed integrations |
envden vault
Re-key the vault, replace the recovery kit, or change or reset the password.
envden vault [options] [command]Subcommands: kit, password, rotate.
envden vault kit
Manage the recovery kit.
envden vault kit [options] [command]Subcommands: replace.
envden vault kit replace
Replace a lost kit; needs the master password.
envden vault kit replace [options]| Option | Description |
|---|---|
--kit-out <file> | Write the new recovery kit as JSON to a private file instead of a PDF |
envden vault password
Change or reset the master password.
envden vault password [options] [command]envden vault password change
Change the password; needs the old one and the kit.
envden vault password change [options]envden vault password reset
Reset a forgotten password with the kit.
envden vault password reset [options]envden vault rotate
Re-key the vault so removed devices can't read new changes.
envden vault rotate [options]envden version
Print the version.
envden version [options]