@phnx-labs/agents-cli 1.17.1 → 1.17.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.17.2
+
+**Fixes**
+
+- Auto-update prompt no longer hangs in non-interactive environments (CI, k8s pods, cloud sandbox factories). The TTY check now requires both stdin and stdout to be terminals before prompting, and `AGENTS_CLI_DISABLE_AUTO_UPDATE=1` forces the check off entirely for headless deploys. ([#15](https://github.com/phnx-labs/agents-cli/issues/15))
+
 ## 1.17.1
 
 **Agent management**

package/README.md

@@ -588,6 +588,8 @@ The installer tries Bun first (faster), falls back to npm. Node 18+ required at
 
 Yes -- `agents run` is non-interactive by default. `--yes` auto-accepts prompts, `--json` for structured output. Pass explicit names and IDs instead of relying on interactive pickers.
 
+The auto-update prompt is suppressed automatically when stdin or stdout isn't a TTY. For headless environments where TTY detection misfires (k8s pods that allocate a PTY for stdout, cloud sandbox factories), set `AGENTS_CLI_DISABLE_AUTO_UPDATE=1` to skip the update check entirely -- no prompt, no network call.
+
 ### What happens to my config when I switch versions?
 
 Each version has its own isolated config directory. Switching just repoints a symlink — your per-version config stays untouched. On first migration (if you had a real `~/.claude/` directory before using agents-cli), that gets backed up once to `~/.agents-system/backups/`.

package/dist/index.js

@@ -60,7 +60,7 @@ import { registerUsageCommand } from './commands/usage.js';
 import { registerAliasCommand } from './commands/alias.js';
 import { registerBetaCommands } from './commands/beta.js';
 import { applyGlobalHelpConventions } from './lib/help.js';
-import { isPromptCancelled } from './commands/utils.js';
+import { isInteractiveTerminal, isPromptCancelled } from './commands/utils.js';
 import { AGENTS } from './lib/agents.js';
 import { getGlobalDefault, listInstalledVersions } from './lib/versions.js';
 import { addShimsToPath, ensureShimCurrent, ensureVersionedAliasCurrent, getPathShadowingExecutable, getPathSetupInstructions, hasAliasShadowingShim, isShimsInPath, listAgentsWithInstalledVersions, removeLegacyUserShim, } from './lib/shims.js';
@@ -240,7 +240,7 @@ function saveUpdateCheck(latestVersion) {
 }
 /** Present an interactive upgrade prompt (TTY) or a one-line hint (non-TTY). */
 async function promptUpgrade(latestVersion) {
-    if (!process.stdout.isTTY) {
+    if (!isInteractiveTerminal()) {
         console.error(chalk.yellow(`Update available: ${VERSION} -> ${latestVersion}. Run: npm install -g @phnx-labs/agents-cli@latest`));
         return;
     }
@@ -309,6 +309,8 @@ function refreshUpdateCacheInBackground() {
 }
 /** Check for available updates using the local cache. Triggers a background refresh if stale. */
 async function checkForUpdates() {
+    if (process.env.AGENTS_CLI_DISABLE_AUTO_UPDATE)
+        return;
     const cache = readUpdateCache();
     // Kick off network refresh in background if stale. Does not block.
     if (shouldFetchLatest(cache)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.17.1",
+  "version": "1.17.2",
   "description": "One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams",
   "type": "module",
   "main": "dist/index.js",