@dotenvx/primitives
4.4.0 · 6 Nov 2026BSD-3-Clause18.4M / weekRepositorynpmAtom feed
58 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 4.x · latest line
4.0.0 – 4.4.014 releases without a noteShow each
- 4.4.06 Nov 2026no note
- 4.3.028 Oct 2026no note
- 4.2.328 Oct 2026no note
- 4.2.228 Oct 2026no note
- 4.2.128 Oct 2026no note
- 4.2.028 Oct 2026no note
- 4.1.028 Oct 2026no note
- 4.0.627 Oct 2026no note
- 4.0.527 Oct 2026no note
- 4.0.427 Oct 2026no note
- 4.0.327 Oct 2026no note
- 4.0.227 Oct 2026no note
- 4.0.127 Oct 2026no note
- 4.0.026 Oct 2026no note
- 3.x
- 2.x
2.2.0
7 Aug 2026Use
dotenvx keychain up|downto move your private keys to your macOS Keychain
2.1.1
26 Jul 2026Support
DOTENV_CONFIG_QUIET=trueas synonym for--quietflag
2.1.0
16 Jul 2026Add interactive input mode for
setSupport leaving
_PLAINsuffixed keys unencrypted duringsetandencryptReturn exit code 1 from
getwhen decryption errors are reported
Added
Add interactive input mode for
setSupport leaving
_PLAINsuffixed keys unencrypted duringsetandencrypt
Changed
Return exit code 1 from
getwhen decryption errors are reported
Fixed
Add Windows PowerShell coverage for npm shim encryption of
.env.localfiles
2.0.0
16 Jul 2026- Breaking
lib/main#
setasync only - Breaking
lib/main#
getasync only - Breaking
Remove the
rotatecommand (it will return in 2.1 or 2.2 soon with a more complete implementation for local and armored keys)
Changed
- Breaking
lib/main#
setasync only - Breaking
lib/main#
getasync only New keyring support - for local and armor providers and to unlock future providers
Route
run,config, andgetthrough shared env and keypair resolvers backed by@dotenvx/primitivesRoute
set,encrypt, anddecryptthrough shared transforms that operate on primitive scan, parse, encrypt, and upsert resultsUpdate library
parseto use primitive parsing while preserving dotenvx-style encrypted value errors
Removed
- Breaking
Remove the
rotatecommand (it will return in 2.1 or 2.2 soon with a more complete implementation for local and armored keys) - Breaking
Remove the library
doctor,keypair, andgenexampleexports fromlib/main
- 1.x
1.10.0
16 Jul 2026- Breaking
Remove
dotenvx ext vault, replace with dotenvx-ext-vault (install there to continue usingext vault)
1.9.0
16 Jul 2026- Breaking
Removed
winston- logger simplified to useconsole.loggoing forward Add
--exclude-key(-ek) option todotenvx encryptanddotenvx decryptPreserve comments and spacing on first-time generation of .env.example file
1.8.1
9 Jul 20261.8.0
9 Jul 2026- Breaking
Remove
picocolorsandcolor-name- cutting down on 2 dependencies - Breaking
Remove
ext hubfrom extension list (you can still install it as an extension here) Warn when decryption fails on
run
Added
Warn when decryption fails on
runDecrypt expanded values as necessary
Changed
Use
ansicolors overrgb- for wider terminal coverageReplace
chalkwithpicocolorsandcolor-name- cutting down on 5 dependenciesReplace
execawithtinyexec- cutting down on 15 dependenciesOptimize
Ls._filepaths
Removed
- Breaking
Remove
picocolorsandcolor-name- cutting down on 2 dependencies - Breaking
Remove
ext hubfrom extension list (you can still install it as an extension here)
1.6.1
30 Jun 2026Add support for
.env1(.env*) file format. (private key expands toDOTENV_PRIVATE_KEY_DEVELOPMENT1)
1.6.0
30 Jun 2026- Breaking
Remove
dotenvx convert- still atdotenvx encrypt - Breaking
Remove
dotenvx vault- still atdotenvx ext vault Add
dotenvx decryptcommand. works inversely todotenvx encrypt. same flags.
Added
Add
dotenvx decryptcommand. works inversely todotenvx encrypt. same flags.Add
--stdoutoption todotenvx decrypt. example:dotenvx decrypt -f .env.production --stdout > somefile.txtAdd
--stdoutoption todotenvx encrypt. example:dotenvx encrypt -f .env.production --stdout > somefile.txt
Changed
Smarter private key finder. if you rename your file to
secrets.txtit can still decrypt fromDOTENV_PRIVATE_KEYby seeking out the invert of theDOTENV_PUBLIC_KEYinsidesecrets.txt
Removed
- Breaking
Remove
dotenvx convert- still atdotenvx encrypt - Breaking
Remove
dotenvx vault- still atdotenvx ext vault
1.5.1
29 Jun 20261.5.0
29 Jun 2026- Breaking
Remove
dotenvx ext hub, replace with dotenvx-ext-hub (install there to continue using hub) Add help text for dashed values on
set. example:dotenvx set KEY -- "- + * ÷"Replace
@inquirer/confirmandora
1.4.0
28 Jun 2026- Breaking
Remove update notice. let users decide what version they want without nagging them to update
- Breaking
Remove
dotenvx hub. still available atdotenvx ext hub
1.3.1
27 Jun 2026🐞 make
patch-packageonly run locally withprepare
1.3.0
27 Jun 2026Encrypt specified keys with
--keyoption -dotenvx encrypt -k HELLO
1.2.0
27 Jun 2026Handle nested
dotenvxinvocations -dotenvx run -- dotenvx run -- envReplace
globwith faster approach
1.1.0
26 Jun 2026Add TypeScript type definitions
1.0.1
26 Jun 2026🐞 fix expansion when preset on
process.envand/or with--overload
1.0.0
25 Jun 2026- Breaking
BREAKING ⚠️: turned on encryption by default for
dotenvx set(usedotenvx set KEY value --plainto set plain values) - Breaking
BREAKING ⚠️: renamed
dotenvx encrypttodotenvx ext vault encrypt(for managing.env.vaultfiles) - Breaking
BREAKING ⚠️: renamed
dotenvx converttodotenvx encrypt
🎉
dotenvxhas made it to1.0.0. There are BREAKING CHANGES ⚠️ .Added
Added
dotenvx set KEY value --plainto set plain text valuesAdded
dotenvx ext🔌 as a location to place extensions likegititgnore,precommit,ls, and more. better than cluttering up core features likerun,get/set, andencrypt.Added
dotenvx pro🏆 command with coming soon and link to GitHub issue (if you wish to be notified of progress. will provide tooling/features for teams)
Changed
- Breaking
BREAKING ⚠️: turned on encryption by default for
dotenvx set(usedotenvx set KEY value --plainto set plain values) - Breaking
BREAKING ⚠️: renamed
dotenvx encrypttodotenvx ext vault encrypt(for managing.env.vaultfiles) - Breaking
BREAKING ⚠️: renamed
dotenvx converttodotenvx encrypt - Breaking
BREAKING ⚠️: moved
lstodotenvx ext ls - Breaking
BREAKING ⚠️: moved
genexampletodotenvx ext genexample - Breaking
BREAKING ⚠️: moved
gitignoretodotenvx ext gitignore - Breaking
BREAKING ⚠️: moved
prebuildtodotenvx ext prebuild - Breaking
BREAKING ⚠️: moved
precommittodotenvx ext precommit - Breaking
BREAKING ⚠️: moved
scantodotenvx ext scan - Breaking
BREAKING ⚠️: moved
hubtodotenvx ext hub - Breaking
BREAKING ⚠️: moved
vaulttodotenvx ext vault - Breaking
BREAKING ⚠️: moved
settingstodotenvx ext settings
(for many of these moved commands, for example
dotenvx genexample, still work in1.0.0but with a large deprecated notice -DEPRECATION NOTICE: [genexample] has moved to [dotenvx ext genexample]. Please change your muscle memory todotenvx ext genexample, as these deprecated command paths will be removed in a later minor version. importantlydotenvx encryptwas not able to be preserved because as it is now in use for encrypted.envfiles rather than.env.vaultfiles)This is a BIG release that sets the tone for
dotenvx's core offering and features while maintaining room for growth. Thank you everyone for your support and usage ofdotenvx🙏.blog post: "From dotenv to dotenvx: Next Generation Config Management"
- 0.11.x
0.11.0
25 Jun 2026- Breaking
No longer append to
*ignorefiles automatically. too invasive. will provide as separate cli command
- 0.10.x
0.10.0
22 Jun 2026Added
dotenvx precommitcommand and instructions for git pre-commit hook
- 0.9.x
0.9.0
22 Jun 2026Remove
.flaskenvfrom appendsImproved error message when .env file is missing
- 0.8.x
- 0.7.x
0.7.1
20 Jun 2026Fix missed package.json#version
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.