envden v0.3.8 is in alpha
Skip to Content
.envden

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>
ArgumentDescription
<repo>Repo ID to alias
<target>Repo ID whose env files it uses

envden config

Read or change settings.

envden config [options] [key] [values...]
ArgumentDescription
[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]
OptionDescription
--jsonPrint the result as JSON
--verboseInclude device ids

envden device rename

Rename this device.

envden device rename [options] <name>
ArgumentDescription
<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>
ArgumentDescription
<device>Device name or ID
OptionDescription
--kit-out <file>Write the new recovery kit as JSON to a private file instead of a PDF
--new-kitAlso replace the recovery kit as part of the removal

envden diff

Show changed key names without values.

envden diff [options]
OptionDescription
--jsonPrint the result as JSON
--allInclude all repos

envden doctor

Check key files, symlinks, updates, Tailscale, HTTPS and shell notices.

envden doctor [options]
OptionDescription
--jsonPrint the report as JSON

envden history

List the versions the server keeps, or restore one as a local edit.

envden history [options] [file]
ArgumentDescription
[file]Env file path
OptionDescription
--allInclude every tracked file
--restore <version>Write that version into the checkout without pushing
--yesConfirm the restore
--jsonPrint the result as JSON

envden join

Join using a pairing code or recovery kit in your own terminal.

envden join [options] <server>
ArgumentDescription
<server>Server address, e.g. envden.your-tailnet.ts.net
OptionDescription
--recoveryPaste a recovery secret key and vault ID
--recovery-kit <path>Recovery kit path
--name <name>Device name
--yesUse 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)
--resumeFinish 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>
ArgumentDescription
<file>Managed env file in this checkout

envden pull

Fetch and merge changes from your other devices.

envden pull [options]
OptionDescription
--jsonPrint the result as JSON
--allSync all repos
--yesConfirm clean changes

envden push

Send your changes to the server.

envden push [options]
OptionDescription
--jsonPrint the result as JSON
--allSync all repos
--yesConfirm clean changes

envden resolve

Keep yours, take the server's, or finish an edited conflict.

envden resolve [options] [file]
ArgumentDescription
[file]Conflicted env file
OptionDescription
--jsonPrint the result as JSON
--listList unresolved conflicts
--repo <path>Select a checkout
--keep-mineKeep your version
--take-serverTake the server's version

envden rm

Remove an env file everywhere on the next push.

envden rm [options] <path>
ArgumentDescription
<path>Env file path
OptionDescription
--yesConfirm deletion, including local edits and conflicts
--jsonPrint the result as JSON

envden serve

Run the server; ENVDEN_SETUP_TOKEN replaces the setup token.

envden serve [options]
OptionDescription
--restoredStart 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]
ArgumentDescription
[server]Destination server address
OptionDescription
--setup-token <token>Setup token, visible to other processes; use the prompt in a terminal
--resumeResume an interrupted move
--abortAbort 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]
OptionDescription
--repair-token <token>Repair token; prefer stdin for upload, use a terminal for --finish
--finishCheck every device's upload and finish the restore
--without <device...>Drop unavailable devices; they rejoin as new devices
--accept-lostAccept 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>
ArgumentDescription
<server>Destination server address

envden setup

Create a vault and configure this device.

envden setup [options]
OptionDescription
--yesTake 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-serverRun 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
--verboseList 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]
ArgumentDescription
[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]
ArgumentDescription
[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]
OptionDescription
--jsonMachine-readable status

envden track

Scan, approve and link checkout env files.

envden track [options] [path]
ArgumentDescriptionDefault
[path]Checkout or scan rootcurrent directory
OptionDescription
--copyPlace real copies instead of links
--verboseList each repo and env file the scan skipped

envden ui

Open a local dashboard for this device.

envden ui [options]
OptionDescription
--port <port>Port on 127.0.0.1 (default: random)
--no-openPrint 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>
ArgumentDescription
<path>Checkout root

envden update

Update envden through the method it was installed with.

envden update [options]
OptionDescription
--checkCheck for a release without installing
--post-installRefresh 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]
OptionDescription
--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]

Subcommands: change, reset.

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]

On this page