@dotenvx/dotenvx 2.7.1 → 2.7.3

package/CHANGELOG.md

@@ -2,7 +2,19 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-[Unreleased](https://github.com/dotenvx/dotenvx/compare/v2.7.1...main)
+[Unreleased](https://github.com/dotenvx/dotenvx/compare/v2.7.3...main)
+
+## [2.7.3](https://github.com/dotenvx/dotenvx/compare/v2.7.2...v2.7.3) (2026-07-13)
+
+### Changed
+
+* Fix: `--quiet` should not display the spinner and its stderr messages ([#889](https://github.com/dotenvx/dotenvx/pull/889))
+
+## [2.7.2](https://github.com/dotenvx/dotenvx/compare/v2.7.1...v2.7.2) (2026-07-13)
+
+### Added
+
+* Include `dotenvx armor status` command.
 
 ## [2.7.1](https://github.com/dotenvx/dotenvx/compare/v2.7.0...v2.7.1) (2026-07-13)
 

package/README.md

@@ -2648,6 +2648,8 @@ Log in to Dotenvx Armor.
 $ dotenvx armor login
 ```
 
+After authentication, dotenvx first attempts to store your access token in your operating system's native secret store: macOS Keychain, Windows Credential Manager, or Linux Secret Service. If native secure storage is unavailable, dotenvx falls back to its settings file. This follows a common CLI credential-storage pattern: prefer protected OS storage when available while remaining usable in headless or minimal environments.
+
 </details>
 <details><summary>`armor logout`</summary><br>
 
@@ -2657,6 +2659,38 @@ Log out of Dotenvx Armor.
 $ dotenvx armor logout
 ```
 
+</details>
+<details><summary>`armor status`</summary><br>
+
+Print the current Armor status. It returns `on` when you are logged in and Armor is enabled; otherwise it returns `off`.
+
+```sh
+$ dotenvx armor status
+on
+```
+
+</details>
+<details><summary>`armor settings`</summary><br>
+
+Inspect and manage your local Armor settings.
+
+```sh
+$ dotenvx armor settings username
+$ dotenvx armor settings token
+$ dotenvx armor settings device
+$ dotenvx armor settings hostname
+$ dotenvx armor settings path
+$ dotenvx armor settings on
+$ dotenvx armor settings off
+```
+
+Access tokens and device public keys are masked by default. Reveal the complete value only when you explicitly need it.
+
+```sh
+$ dotenvx armor settings token --unmask
+$ dotenvx armor settings device --unmask
+```
+
 </details>
 <details><summary>`help`</summary><br>
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.7.1",
+  "version": "2.7.3",
   "name": "@dotenvx/dotenvx",
   "description": "a secure dotenv–from the creator of `dotenv`",
   "author": "@motdotla",

package/src/cli/actions/armor/down.js

@@ -6,7 +6,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function down () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'dearmoring' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'dearmoring' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/armor/move.js

@@ -6,7 +6,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function move () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'moving' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'moving' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/armor/pull.js

@@ -6,7 +6,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function pull () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'pulling' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'pulling' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/armor/push.js

@@ -6,7 +6,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function push () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'pushing' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'pushing' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/armor/status.js

@@ -0,0 +1,7 @@
+const Session = require('../../../db/session')
+
+function status () {
+  console.log(new Session().status())
+}
+
+module.exports = status

package/src/cli/actions/armor/up.js

@@ -6,7 +6,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function up () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'armoring' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'armoring' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/decrypt.js

@@ -10,7 +10,8 @@ const maskEnvSrc = require('../../lib/helpers/maskEnvSrc')
 
 async function decrypt () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'decrypting' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'decrypting' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/encrypt.js

@@ -9,7 +9,8 @@ const Session = require('../../db/session')
 
 async function encryptAction () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'encrypting' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'encrypting' })
   const sesh = new Session()
 
   logger.debug(`options: ${JSON.stringify(options)}`)

package/src/cli/actions/get.js

@@ -12,7 +12,8 @@ const mask = require('../../lib/helpers/mask')
 
 async function get (key) {
   const options = normalizeDotenvConfigConvention(this.opts())
-  const spinner = await createSpinner({ ...options, text: 'decrypting' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'decrypting' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
   if (key) {

package/src/cli/actions/keychain/down.js

@@ -5,7 +5,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function down () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'unkeychaining' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'unkeychaining' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/keychain/pull.js

@@ -5,7 +5,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function pull () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'pulling' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'pulling' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/keychain/push.js

@@ -5,7 +5,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function push () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'pushing' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'pushing' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/keychain/up.js

@@ -5,7 +5,8 @@ const armoredKeyDisplay = require('../../../lib/helpers/armoredKeyDisplay')
 
 async function up () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'storing' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'storing' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/keypair.js

@@ -6,7 +6,8 @@ const createSpinner = require('../../lib/helpers/createSpinner')
 
 async function keypair (key) {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'retrieving' })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'retrieving' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
   if (key) {

package/src/cli/actions/login.js

@@ -12,7 +12,8 @@ const FRAMES = ['◐', '◓', '◑', '◒']
 
 async function login () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'logging in', frames: FRAMES })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'logging in', frames: FRAMES })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/logout.js

@@ -8,7 +8,8 @@ const FRAMES = ['◐', '◓', '◑', '◒']
 
 async function logout () {
   const options = this.opts()
-  const spinner = await createSpinner({ ...options, text: 'logging out', frames: FRAMES })
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'logging out', frames: FRAMES })
 
   logger.debug(`options: ${JSON.stringify(options)}`)
 

package/src/cli/actions/run.js

@@ -51,6 +51,7 @@ function uniqueInjectedKeys (processedEnvs) {
 
 async function run () {
   const options = normalizeDotenvConfigConvention(normalizeDotenvConfigQuiet(this.opts()))
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
   const maskEnabled = options.mask !== undefined
   let showChar = options.mask
   if (options.mask === true) {
@@ -63,7 +64,7 @@ async function run () {
     commandArgs = inferCommandArgsFromProcessArgv(process.argv)
   }
 
-  const spinner = await createSpinner({ ...options, text: 'injecting' })
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: 'injecting' })
 
   let debugOptions = options
   if (maskEnabled) {

package/src/cli/actions/set.js

@@ -11,6 +11,7 @@ const Session = require('../../db/session')
 
 async function set (key, value) {
   const options = this.opts()
+  const spinnerOptions = typeof this.optsWithGlobals === 'function' ? this.optsWithGlobals() : options
 
   let encrypt = true
   let settingMessage = 'encrypting'
@@ -47,7 +48,7 @@ async function set (key, value) {
     }
   }
 
-  const spinner = await createSpinner({ ...options, text: settingMessage })
+  const spinner = await createSpinner({ ...spinnerOptions, ...options, text: settingMessage })
   const sesh = new Session()
 
   logger.debug(`key: ${key}`)

package/src/cli/commands/armor.js

@@ -91,6 +91,14 @@ function configureArmorCommand (armor) {
       return require('./../actions/logout').apply(this, args)
     })
 
+  // dotenvx armor status
+  armor
+    .command('status')
+    .description('print armor status')
+    .action(function (...args) {
+      return require('./../actions/armor/status').apply(this, args)
+    })
+
   // dotenvx armor settings
   require('./settings')(armor.command('settings'))