Command Reference
Interactive Mode
Launches interactive mode with a menu of all available actions. Best for day-to-day use — guides you through each step with prompts and confirmations.
Environment Commands
Downloads .env files from 1Password using your .tpl template files. Templates define which secrets to fetch. Use --force to overwrite existing local files without prompting.
Uploads local .env files back to 1Password. Syncs any changes you've made locally to the vault. Use --force to overwrite vault items without prompting.
Build & Deploy Commands
Builds a Docker image and pushes it to GitHub Container Registry (GHCR).
Tags the image with both the version from package.json and latest.
Add --deploy to automatically trigger deployment after a successful build.
Requires a running Docker daemon (with buildx) and a GitHub login
with write:packages — both are checked automatically, and the CLI will prompt for
gh auth login if needed.
Triggers a deployment on Dokploy using the existing image on GHCR. No rebuild occurs — this just deploys what's already been pushed.
Creates or updates your project configuration on Dokploy. Sets up the project, environment, compose file, and domain. Run this first when setting up a new project. Add --deploy to trigger deployment after syncing.
Account
Refreshes GitHub authentication (with write:packages) and, if the
build feature is enabled, forces a fresh docker login ghcr.io using the
current gh token. Use this if your token expired or you switched GitHub accounts mid-session.
Typical Workflow
Notes
.env.deploy.local
.tpl templates are updated, run env:pull to fetch the latest secrets
.env files locally, run env:push to sync to 1Password, then sync to update Dokploy
compose.yml or .env.deploy.local changes, run sync to update Dokploy
build. The CLI verifies
the daemon on every build and prints platform-specific hints (e.g. open -a Docker on
macOS) if it's missing or stopped