Getting Started

Start using inject in 60 seconds.

Install inject, run setup in your project, and your existing commands work the same way — with secrets injected securely from memory.

Quickstart

1

Install inject via Homebrew.

brew tap dynamicHarsh/tap && brew install inject
2

Run setup in your project directory. inject creates a project configuration and walks you through connecting a source.

inject setup
3

Run your usual commands. inject handles the rest.

npm run dev

Local .env example

You have an existing .env file with project secrets. inject imports them into the credential store so you can delete the plaintext file.

1

Run setup. inject detects the .env file and offers to import its secrets.

inject setup
# [inject] Found .env with 12 secrets.
# [inject] Import into credential store? (Y/n)
2

Confirm the import. inject stores the secrets in the credential store, scoped to your project ID.

# [inject] Imported 12 secrets into credential store.
# [inject] You can now safely delete .env.
3

Delete the plaintext .env file and run your command as usual.

rm .env
npm run dev
# > Ready on http://localhost:3000

1Password team example

Your team stores secrets in a 1Password remote secret note. Each developer runs setup once to connect their local project to the shared vault.

1

Make sure the 1Password CLI is installed and you have an active provider CLI session.

op signin
2

Run setup and select 1Password as the secret provider. inject reads the remote reference from the project configuration.

inject setup
# [inject] Connected to 1Password vault "Engineering".
3

Run your command. inject fetches the secret set from 1Password via the existing CLI session and injects it into your process.

npm run dev
# > Ready on http://localhost:3000

Bitwarden team example

Same pattern as 1Password — your team stores secrets in a Bitwarden remote secret note, and inject reads from the Bitwarden CLI session.

1

Make sure the Bitwarden CLI is installed and you have an active provider CLI session.

bw login && bw unlock
2

Run setup and select Bitwarden as the secret provider.

inject setup
# [inject] Connected to Bitwarden vault "Engineering".
3

Run your command. inject fetches the secret set from Bitwarden and injects it into your process.

npm run dev
# > Ready on http://localhost:3000