CLI reference on ZTD — Zero Trust Dev

ztd

Mon, 01 Jan 0001 00:00:00 +0000

ztd

Zero Trust Dev — disposable isolated VMs for untrusted dev work

Options

 -h, --help help for ztd

ztd attach

Mon, 01 Jan 0001 00:00:00 +0000

ztd attach

Reattach to the guest agent’s tmux session (bash scripts/run-agent.sh attach)

ztd attach [flags]

Options

 -h, --help help for attach

ztd audit

Mon, 01 Jan 0001 00:00:00 +0000

ztd audit

Export a run’s audit record to .ztd/runs/ (bash scripts/audit.sh)

ztd audit [flags]

Options

 -h, --help help for audit

ztd auth

Mon, 01 Jan 0001 00:00:00 +0000

ztd auth

Sync the operator’s Claude Code login into the guest (bash scripts/auth-sync.sh)

ztd auth [flags]

Options

 -h, --help help for auth

ztd cattle

Mon, 01 Jan 0001 00:00:00 +0000

ztd cattle

One-shot up→auth→skills→commands→run (bash scripts/cattle.sh)

ztd cattle [flags]

Options

 -h, --help help for cattle

ztd check

Mon, 01 Jan 0001 00:00:00 +0000

ztd check

Run the host-side preflight (bash scripts/check-requirements.sh)

ztd check [flags]

Options

 -h, --help help for check

ztd commands

Mon, 01 Jan 0001 00:00:00 +0000

ztd commands

Provision/pull the guest agent’s ~/.claude/commands (bash scripts/agent-sync.sh commands)

ztd commands [flags]

Options

 -h, --help help for commands

ztd config

Mon, 01 Jan 0001 00:00:00 +0000

ztd config

Print the resolved ztd configuration

ztd config [flags]

Options

 -h, --help help for config

ztd down

Mon, 01 Jan 0001 00:00:00 +0000

ztd down

Tear down the VM (discards the ephemeral key + transient git remote on success)

ztd down [flags]

Options

 -h, --help help for down

ztd fetch

Mon, 01 Jan 0001 00:00:00 +0000

ztd fetch

Fetch the guest’s commits into the operator’s checkout (bash scripts/fetch-remote.sh)

ztd fetch [flags]

Options

 -h, --help help for fetch

ztd init

Mon, 01 Jan 0001 00:00:00 +0000

ztd init

Scaffold this project’s .ztd/ztd.toml (the single config file)

ztd init [flags]

Options

 -h, --help help for init

ztd ip

Mon, 01 Jan 0001 00:00:00 +0000

ztd ip

Print the VM’s IP address

ztd ip [flags]

Options

 -h, --help help for ip

ztd list:orphans

Mon, 01 Jan 0001 00:00:00 +0000

ztd list:orphans

List orphaned VMs/resources not tracked by state

ztd list:orphans [flags]

Options

 -h, --help help for list:orphans

ztd logs

Mon, 01 Jan 0001 00:00:00 +0000

ztd logs

Follow guest cloud-init/provisioning output

ztd logs [flags]

Options

 -h, --help help for logs

ztd mount

Mon, 01 Jan 0001 00:00:00 +0000

ztd mount

SSHFS-mount a remote guest’s repo (bash scripts/mount-remote.sh mount)

ztd mount [flags]

Options

 -h, --help help for mount

ztd plan

Mon, 01 Jan 0001 00:00:00 +0000

ztd plan

Show the Terraform plan for the VM

ztd plan [flags]

Options

 -h, --help help for plan

ztd purge

Mon, 01 Jan 0001 00:00:00 +0000

ztd purge

Destroy all ztd-managed resources

ztd purge [flags]

Options

 -h, --help help for purge

ztd reset

Mon, 01 Jan 0001 00:00:00 +0000

ztd reset

Recreate the VM (down+up; keeps the ephemeral key)

ztd reset [flags]

Options

 -h, --help help for reset

ztd run

Mon, 01 Jan 0001 00:00:00 +0000

ztd run

Launch the agent in a guest tmux session (bash scripts/run-agent.sh run)

ztd run [flags]

Options

 -h, --help help for run

ztd setup

Mon, 01 Jan 0001 00:00:00 +0000

ztd setup

Install the persistent Docker→libvirt forwarding fix (–transient, –undo)

ztd setup [flags]

Options

 -h, --help help for setup

ztd skills

Mon, 01 Jan 0001 00:00:00 +0000

ztd skills

Provision/pull the guest agent’s ~/.claude/skills (bash scripts/agent-sync.sh skills)

ztd skills [flags]

Options

 -h, --help help for skills

ztd ssh

Mon, 01 Jan 0001 00:00:00 +0000

ztd ssh

Shell into the VM (ephemeral key)

ztd ssh [flags]

Options

 -h, --help help for ssh

ztd status

Mon, 01 Jan 0001 00:00:00 +0000

ztd status

Report the ztd VM’s status (–watch for a live readiness dashboard)

ztd status [flags]

Options

 -h, --help help for status
 --timeout duration how long --watch waits for the guest to be fully ready before giving up (default 10m0s)
 --watch live readiness dashboard: poll the guest and watch features (SSH, cloud-init, virtiofs repo, Docker, Node, Claude) go green as they come online

ztd test

Mon, 01 Jan 0001 00:00:00 +0000

ztd test

Run the full acceptance suite for the current backend (bash scripts/smoke-test[-proxmox|-ec2].sh)

ztd test [flags]

Options

 -h, --help help for test

ztd test:config

Mon, 01 Jan 0001 00:00:00 +0000

ztd test:config

Run the VM-free config-loader unit test (bash scripts/test-config.sh)

ztd test:config [flags]

Options

 -h, --help help for test:config

ztd tunnel

Mon, 01 Jan 0001 00:00:00 +0000

ztd tunnel

Forward a VM port to localhost (default 8080; e.g. ztd tunnel 8080)

ztd tunnel [port] [flags]

Options

 -h, --help help for tunnel

ztd unmount

Mon, 01 Jan 0001 00:00:00 +0000

ztd unmount

Unmount a remote guest’s repo (bash scripts/mount-remote.sh unmount)

ztd unmount [flags]

Options

 -h, --help help for unmount

ztd up

Mon, 01 Jan 0001 00:00:00 +0000

ztd up

Boot the VM (generates the ephemeral guest key first)

ztd up [flags]

Options

 -h, --help help for up

ztd validate

Mon, 01 Jan 0001 00:00:00 +0000

ztd validate

Validate the Terraform configuration

ztd validate [flags]

Options

 -h, --help help for validate

ztd version

Mon, 01 Jan 0001 00:00:00 +0000

ztd version

Print the ztd version

ztd version [flags]

Options

 -h, --help help for version

CLI reference on ZTD — Zero Trust Dev

ztd

ztd

Options

SEE ALSO

ztd attach

ztd attach

Options

SEE ALSO

ztd audit

ztd audit

Options

SEE ALSO

ztd auth

ztd auth

Options

SEE ALSO

ztd cattle

ztd cattle

Options

SEE ALSO

ztd check

ztd check

Options

SEE ALSO

ztd commands

ztd commands

Options

SEE ALSO

ztd config

ztd config

Options

SEE ALSO

ztd down

ztd down

Options

SEE ALSO

ztd fetch

ztd fetch

Options

SEE ALSO

ztd init

ztd init

Options

SEE ALSO

ztd ip

ztd ip

Options

SEE ALSO

ztd list:orphans

ztd list:orphans

Options

SEE ALSO

ztd logs

ztd logs

Options

SEE ALSO

ztd mount

ztd mount

Options

SEE ALSO

ztd plan

ztd plan

Options

SEE ALSO

ztd purge

ztd purge

Options

SEE ALSO

ztd reset

ztd reset

Options

SEE ALSO

ztd run

ztd run

Options

SEE ALSO

ztd setup

ztd setup

Options