CLI

handoff diff

Compare your local .env to the remote version before pushing or pulling.

Usage

handoff diff [--env <name>] [--file <path>]

What it does

Shows a per-key diff between your local file and the selected remote environment:

  • + keys only on the remote
  • - keys only in your local file
  • ~ keys that exist in both but disagree

Values are redacted in the output (only key names are printed), so you can safely run diff in a shared terminal.

Example output

~ STRIPE_SECRET_KEY     (differs)
+ SENTRY_DSN            (remote only)
- LEGACY_FEATURE_FLAG   (local only)

Flags

FlagDefaultDescription
-e, --env <name>default env from .handoff/config.jsonEnvironment to compare against
-f, --file <path>.envLocal file to compare
Previoushandoff pullNexthandoff run