Passbook CLI

CLI for linking a local repository to a Passbook project and syncing .env files with Passbook environments.

Install

npm install -g @prmworks/passbook

Full Guide

For a complete getting-started walkthrough and interactive command reference, see GUIDE.md.

Commands

passbook login
passbook whoami
passbook project link
passbook project create
passbook project unlink
passbook env link
passbook env create
passbook env list
passbook env unlink
passbook pull
passbook push
passbook -v
passbook --help

Examples

passbook login
passbook project link
passbook env link
passbook pull
passbook push

Non-interactive examples

passbook project link --project-id proj_123 --non-interactive
passbook env link --env-id env_123 --file apps/auth-ui/.env.local --non-interactive
passbook pull env_123 --force --non-interactive
passbook push env_123 --force --non-interactive

Notes

• passbook login opens passbook.prmworks.com in your browser and completes sign-in there.
• Browser login can use any web auth method currently available in Passbook, including Google and existing email/password accounts.
• .passbook/config.json is created in the linked repo root.
• Mappings use remote IDs and repo-relative file paths.
• pull and push can infer the target environment from the current working directory.
• pull and push skip unchanged env targets automatically.
• Interactive overwrite flows now show a colorized line diff before confirmation.
• pull creates missing local files.
• push fails if the local file is missing.
• --force skips overwrite prompts and diff previews, but unchanged targets still skip.
• In non-interactive mode, required flags must be provided and overwrite actions require --force.
• Output is colorized automatically in interactive terminals.
• Set NO_COLOR to disable colored output.

Author

Created by pradeep