1Password Environment Variable Manager

A TypeScript CLI tool to manage environment variables using 1Password. It allows you to:

• Upload your .env file to 1Password as individual password fields
• Download environment variables from 1Password back to .env format
• Configure default vault and item names for persistent usage

Prerequisites

1. Install 1Password CLI: https://developer.1password.com/docs/cli/get-started/
2. Login to 1Password CLI: op signin

Installation

npm install -g op-env-manager

Usage

Get started in seconds:

# Configure your default vault
op-env config --vault <vault-name>

# Push your .env file to 1Password
op-env push

# Pull environment variables from 1Password to your local .env file
op-env pull

For a full list of commands and options, run:

op-env --help

Commands

config

Configure global settings for 1Password vault.

op-env config --vault <vault>

• --vault <vault>: Set the default 1Password vault name or ID.

push

Upload your .env file to 1Password as an item with individual fields.

op-env push [options]

• -f, --file <file>: Path to the .env file (default: .env)
• -v, --vault <vault>: 1Password vault name or ID (overrides global config)
• -i, --item <item>: 1Password item name (default: directory name)

pull

Download environment variables from 1Password and write them to a .env file.

op-env pull [options]

• -f, --file <file>: Path to the .env file to write (default: .env)
• -v, --vault <vault>: 1Password vault name or ID (overrides global config)
• -i, --item <item>: 1Password item name (default: directory name)

For all commands, you can use -h or --help to see available options.