@mndrk/agx 2.4.3 → 2.4.5

package/lib/cli/onboarding.js

@@ -184,6 +184,27 @@ ${c.bold}${c.cyan}╰───────────────────
         }
       }
     }
+  } else if (defaultProvider === 'zai') {
+    const zaiModels = ['glm-5.1', 'glm-5-turbo', 'glm-4.5-air'];
+    console.log(`\n${c.bold}Choose your default model:${c.reset}`);
+    zaiModels.forEach((m, i) => {
+      console.log(`  ${c.cyan}${i + 1}${c.reset}) ${m}`);
+    });
+    console.log(`  ${c.cyan}${zaiModels.length + 1}${c.reset}) Other`);
+    while (!defaultModel) {
+      const choice = await prompt(`\nEnter number [${c.dim}1${c.reset}]: `);
+      if (!choice) {
+        defaultModel = zaiModels[0];
+      } else if (choice === String(zaiModels.length + 1)) {
+        const custom = await prompt(`\nEnter model name: `);
+        if (custom && custom.trim()) defaultModel = custom.trim();
+      } else {
+        const n = parseInt(choice, 10);
+        if (Number.isInteger(n) && n >= 1 && n <= zaiModels.length) {
+          defaultModel = zaiModels[n - 1];
+        }
+      }
+    }
   } else if (defaultProvider === 'gemini') {
     const geminiModels = ['gemini-3-pro-preview', 'gemini-3-flash-preview'];
     console.log(`\n${c.bold}Choose your default model:${c.reset}`);
@@ -374,7 +395,7 @@ async function runConfigMenu() {
 
   switch (choice) {
     case '1': {
-      const missing = ['claude', 'gemini', 'ollama', 'codex'].filter((p) => !providers[p]);
+      const missing = ['claude', 'gemini', 'ollama', 'codex', 'zai'].filter((p) => !providers[p]);
       if (missing.length === 0) {
         console.log(`\n${c.green}✓${c.reset} All providers are already installed!`);
         break;

package/lib/cli/providers.js

@@ -6,14 +6,19 @@ const execa = require('execa');
 
 const { c } = require('../ui/colors');
 const { commandExists, resolveCommand } = require('../proc/commandExists');
-const { prompt } = require('./configStore');
+const { prompt, loadConfig, saveConfig } = require('./configStore');
 
 function detectProviders() {
+  const claudePath = resolveCommand('claude') || false;
+  const config = loadConfig();
+  const hasZaiKey = Boolean(config?.zai?.apiKey);
   return {
-    claude: resolveCommand('claude') || false,
+    claude: claudePath,
     gemini: resolveCommand('gemini') || false,
     ollama: resolveCommand('ollama') || false,
     codex: resolveCommand('codex') || false,
+    // z.ai routes through Claude CLI — "installed" means claude CLI + key configured
+    zai: claudePath && hasZaiKey ? claudePath : false,
   };
 }
 
@@ -28,6 +33,7 @@ function printProviderStatus(providers) {
   console.log(`  ${c.cyan}gemini${c.reset}  │ Google Gemini CLI      │ ${status(providers.gemini)}`);
   console.log(`  ${c.cyan}ollama${c.reset}  │ Local Ollama           │ ${status(providers.ollama)}`);
   console.log(`  ${c.cyan}codex${c.reset}   │ OpenAI Codex CLI       │ ${status(providers.codex)}`);
+  console.log(`  ${c.cyan}zai${c.reset}     │ Z.AI (GLM via Claude)  │ ${status(providers.zai)}`);
 }
 
 function runInteractive(cmd, args = [], options = {}) {
@@ -97,6 +103,11 @@ const PROVIDERS = {
     name: 'Codex CLI',
     installCmd: 'npm install -g @openai/codex',
     description: 'OpenAI Codex CLI'
+  },
+  zai: {
+    name: 'Z.AI',
+    installCmd: 'npm install -g @anthropic-ai/claude-code',
+    description: 'Z.AI GLM models via Claude Code'
   }
 };
 
@@ -104,6 +115,20 @@ async function installProvider(provider) {
   const info = PROVIDERS[provider];
   if (!info) return false;
 
+  // z.ai "install" just means configuring the API key (claude CLI is the actual binary)
+  if (provider === 'zai') {
+    if (!commandExists('claude')) {
+      console.log(`\n${c.cyan}Installing Claude Code (required for z.ai)...${c.reset}\n`);
+      console.log(`${c.dim}$ ${info.installCmd}${c.reset}\n`);
+      await runInteractive(info.installCmd);
+      if (!commandExists('claude')) {
+        console.log(`\n${c.red}✗${c.reset} Claude CLI install failed.`);
+        return false;
+      }
+    }
+    return loginProvider('zai');
+  }
+
   console.log(`\n${c.cyan}Installing ${info.name}...${c.reset}\n`);
   console.log(`${c.dim}$ ${info.installCmd}${c.reset}\n`);
 
@@ -195,6 +220,25 @@ async function loginProvider(provider) {
     return true;
   }
 
+  if (provider === 'zai') {
+    if (!commandExists('claude')) {
+      console.log(`${c.yellow}Claude CLI is required for z.ai.${c.reset}`);
+      console.log(`${c.dim}Install: npm install -g @anthropic-ai/claude-code${c.reset}`);
+      return false;
+    }
+    console.log(`${c.cyan}Configure Z.AI access${c.reset}`);
+    console.log(`${c.dim}Get your API key from https://z.ai/manage-apikey/apikey-list${c.reset}\n`);
+    const key = (await prompt('  Enter Z.AI API key: ')).trim();
+    if (!key) {
+      console.log(`${c.yellow}No key entered. Skipping.${c.reset}`);
+      return false;
+    }
+    const config = loadConfig() || {};
+    saveConfig({ ...config, zai: { ...(config.zai || {}), apiKey: key } });
+    console.log(`\n${c.green}✓${c.reset} Z.AI API key saved to ${c.dim}~/.agx/config.json${c.reset}`);
+    return true;
+  }
+
   return false;
 }
 

package/lib/cli/runCli.js

@@ -1385,7 +1385,8 @@ async function checkOnboarding() {
     'c': 'claude', 'cl': 'claude', 'claude': 'claude',
     'x': 'codex', 'codex': 'codex',
     'g': 'gemini', 'gem': 'gemini', 'gemini': 'gemini',
-    'o': 'ollama', 'ol': 'ollama', 'ollama': 'ollama'
+    'o': 'ollama', 'ol': 'ollama', 'ollama': 'ollama',
+    'z': 'zai', 'zai': 'zai', 'z.ai': 'zai'
   };
 
   function normalizeApprovalMode(value) {
@@ -1764,6 +1765,12 @@ async function checkOnboarding() {
     return true;
   }
 
+  if (cmd === 'narrate-prs') {
+    const { handleNarratePrs } = require('../commands/narratePrs');
+    await handleNarratePrs({ args: args.slice(1), ctx: { c } });
+    return true;
+  }
+
   // ============================================================
   // DIRECT COMMANDS - No 'cloud' prefix needed
   // ============================================================
@@ -1833,6 +1840,22 @@ async function checkOnboarding() {
     if (handledProject) return true;
   }
 
+  {
+    const { maybeHandleTeamsCommand } = require('../commands/teams');
+    const handledTeams = await maybeHandleTeamsCommand({
+      cmd,
+      args,
+      ctx: {
+        c,
+        cloudRequest,
+        loadCloudConfigFile,
+        resolveProjectByIdentifier,
+        prompt,
+      }
+    });
+    if (handledTeams) return true;
+  }
+
   {
     const { maybeHandleRepoCommand } = require('../commands/repo');
     const handledRepo = await maybeHandleRepoCommand({
@@ -1847,6 +1870,22 @@ async function checkOnboarding() {
     if (handledRepo) return true;
   }
 
+  {
+    const { maybeHandleWorkspaceCommand } = require('../commands/workspace');
+    const handledWorkspace = await maybeHandleWorkspaceCommand({
+      cmd,
+      args,
+      ctx: {
+        c,
+        cloudRequest,
+        loadCloudConfigFile,
+        resolveProjectByIdentifier,
+        prompt,
+      }
+    });
+    if (handledWorkspace) return true;
+  }
+
   {
     const { maybeHandleVarsCommand } = require('../commands/vars');
     const handledVars = await maybeHandleVarsCommand({
@@ -3746,10 +3785,13 @@ async function runCli(argv = process.argv) {
       'codex': 'codex',
       'o': 'ollama',
       'ol': 'ollama',
-      'ollama': 'ollama'
+      'ollama': 'ollama',
+      'z': 'zai',
+      'zai': 'zai',
+      'z.ai': 'zai'
     };
 
-    const VALID_PROVIDERS = ['gemini', 'claude', 'ollama', 'codex'];
+    const VALID_PROVIDERS = ['gemini', 'claude', 'ollama', 'codex', 'zai'];
 
     // Handle help
     if (args.includes('--help') || args.includes('-h')) {
@@ -3786,6 +3828,7 @@ PROVIDERS:
   codex, x     OpenAI Codex
   gemini, g    Google Gemini
   ollama, o    Local Ollama
+  zai, z       Z.AI GLM models (via Claude Code)
 
   CLOUD:
   agx new "<task>"       Create task in cloud
@@ -3798,6 +3841,8 @@ PROVIDERS:
   agx reject <task>      Reject an awaiting gate
   agx approve <task> --node <id> -m "feedback"
   agx repo add . --project <project>  Analyze current repo and attach it to a project
+  agx workspace list [--project <project>]     Show the workspace map
+  agx workspace add repos backend /code/api    Add a workspace entry
   agx project assign <project> --task <task>   Assign task to project
   agx project unassign --task <task>           Remove project assignment from task
 
@@ -3824,6 +3869,7 @@ EXAMPLES:
   agx -a -p "Build a todo app"    # Start autonomous task
   agx claude -p "explain this"    # One-shot question
   agx codex -p "refactor this"    # One-shot question
+  agx zai -p "hello"              # Use Z.AI (GLM) models
   agx task ls               # Check cloud tasks
   agx container logs         # See what's happening
 
@@ -3838,6 +3884,19 @@ SCHEDULING:
   agx schedule runs <id>      List run history
   agx schedule cancel <id>    Cancel active run
 
+PR NARRATIVES:
+  agx narrate-prs [path]      Analyze merged PRs as product/marketing narrative (incremental)
+  agx narrate-prs ls [path]   Show storage, state, and file counts
+  agx narrate-prs where [path] Print storage directory
+  agx narrate-prs cat [path]   Concatenate narratives (--from N --to N --output file)
+    Flags: --provider, --model, --concurrency, --limit, --since, --force,
+           --dry-run, --prompt-file, --output-dir
+
+REMOTE ACCESS:
+  agx board share            Enable remote access via Tailscale
+  agx board share --off      Disable remote access
+  agx board share --status   Show remote access status
+
 TELEMETRY:
   agx telemetry              Show telemetry status
   agx telemetry on/off       Enable/disable anonymous usage data
@@ -3866,7 +3925,8 @@ SUPPORT:
         console.log(`  ${c.dim}agx claude --prompt "hello"${c.reset}`);
         console.log(`  ${c.dim}agx codex --prompt "hello"${c.reset}`);
         console.log(`  ${c.dim}agx gemini --prompt "hello"${c.reset}`);
-        console.log(`  ${c.dim}agx ollama --prompt "hello"${c.reset}\n`);
+        console.log(`  ${c.dim}agx ollama --prompt "hello"${c.reset}`);
+        console.log(`  ${c.dim}agx zai --prompt "hello"${c.reset}\n`);
         process.exit(1);
       }
     }
@@ -4076,6 +4136,36 @@ SUPPORT:
       // Allow running outside a git repo (e.g. when spawned from daemon in ~/).
       translatedArgs.push('--skip-git-repo-check');
 
+      if (finalPrompt) {
+        translatedArgs.push(finalPrompt);
+      }
+    } else if (provider === 'zai') {
+      // Z.AI routes through Claude CLI with z.ai base URL and GLM model mappings
+      command = 'claude';
+      translatedArgs.length = 0; // Clear any accumulated args
+
+      const zaiKey = config?.zai?.apiKey || process.env.ZAI_API_KEY || '';
+      if (!zaiKey) {
+        console.error(`${c.red}Error:${c.reset} No Z.AI API key configured.`);
+        console.error(`Run ${c.cyan}agx config${c.reset} and choose "Login to a provider" → zai, or set ${c.cyan}ZAI_API_KEY${c.reset}.`);
+        process.exit(1);
+      }
+
+      env.ANTHROPIC_AUTH_TOKEN = zaiKey;
+      env.ANTHROPIC_BASE_URL = 'https://api.z.ai/api/anthropic';
+      env.ANTHROPIC_API_KEY = '';
+      env.ANTHROPIC_DEFAULT_HAIKU_MODEL = 'glm-4.5-air';
+      env.ANTHROPIC_DEFAULT_SONNET_MODEL = 'glm-5-turbo';
+      env.ANTHROPIC_DEFAULT_OPUS_MODEL = 'glm-5.1';
+
+      if (options.yolo) translatedArgs.push('--dangerously-skip-permissions');
+      if (options.print || (finalPrompt && !options.interactive)) {
+        translatedArgs.push('--print');
+      }
+      if (options.mcp) translatedArgs.push('--mcp-config', options.mcp);
+      if (options.model) {
+        translatedArgs.push('--model', options.model);
+      }
       if (finalPrompt) {
         translatedArgs.push(finalPrompt);
       }

package/lib/commands/board.js

@@ -0,0 +1,155 @@
+'use strict';
+
+const execa = require('execa');
+const { c } = require('../ui/colors');
+const { isBoardRunning, ensureBoardRunning, getBoardPort, loadBoardEnv, saveBoardEnvValue } = require('../cli/daemon');
+const { commandExists } = require('../proc/commandExists');
+
+// Check if tailscale CLI is available
+async function checkTailscale() {
+  if (!await commandExists('tailscale')) {
+    console.log(`${c.red}✗${c.reset} Tailscale CLI not found`);
+    console.log(`  ${c.dim}Install Tailscale: https://tailscale.com/kb/1069/install-macos/${c.reset}`);
+    console.log(`  ${c.dim}Then run: ${c.cyan}tailscale login${c.reset}`);
+    return false;
+  }
+  return true;
+}
+
+// Get Tailscale DNS name for this machine
+async function getTailscaleFqdn() {
+  try {
+    const { stdout } = await execa('tailscale', ['status', '--json']);
+    const status = JSON.parse(stdout);
+    const dns = status.Self?.DNSName;
+    if (dns) return dns.replace(/\.$/, ''); // strip trailing dot
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// Check if a local port is being served via tailscale serve
+async function isTailscaleServed(port) {
+  try {
+    const { stdout } = await execa('tailscale', ['serve', 'status', '--json']);
+    const status = JSON.parse(stdout);
+    if (!status.Web) return false;
+    const portStr = String(port);
+    for (const host of Object.values(status.Web)) {
+      for (const handler of Object.values(host.Handlers || {})) {
+        if (handler.Proxy && handler.Proxy.endsWith(':' + portStr)) return true;
+      }
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Handle `agx board share` subcommand.
+ * Called from daemonBoard.js when subcmd === 'share'.
+ */
+async function handleBoardShare({ args, ctx }) {
+  const { getBoardPort: ctxGetBoardPort } = ctx;
+  if (!(await checkTailscale())) {
+    process.exit(1);
+  }
+
+  const isOff = args.includes('--off');
+  const isStatus = args.includes('--status');
+  const port = ctxGetBoardPort ? ctxGetBoardPort() : getBoardPort();
+
+  // ── share --status ─────────────────────────────────────────────
+  if (isStatus) {
+    const isServed = await isTailscaleServed(port);
+    const boardEnv = loadBoardEnv();
+    const configuredUrl = boardEnv.AGX_BOARD_URL;
+
+    console.log(`${c.bold}Board Remote Access Status${c.reset}\n`);
+    console.log(`  ${c.dim}Port:${c.reset}        ${port}`);
+    console.log(`  ${c.dim}Tailscale:${c.reset}  ${isServed ? c.green + 'serving' + c.reset : c.dim + 'not serving' + c.reset}`);
+    console.log(`  ${c.dim}Config URL:${c.reset} ${configuredUrl || c.dim + '(none)' + c.reset}`);
+
+    if (configuredUrl && isServed) {
+      console.log(`\n  ${c.green}✓${c.reset} Access your board at: ${c.cyan}${configuredUrl}${c.reset}`);
+    } else if (configuredUrl) {
+      console.log(`\n  ${c.yellow}⚠${c.reset} URL configured but Tailscale Serve not active`);
+      console.log(`  ${c.dim}Run ${c.cyan}agx board share${c.reset} to enable`);
+    } else {
+      console.log(`\n  ${c.dim}Run ${c.cyan}agx board share${c.reset} to enable remote access`);
+    }
+
+    process.exit(0);
+  }
+
+  // ── share --off ────────────────────────────────────────────────
+  if (isOff) {
+    console.log(`${c.dim}Disabling Tailscale Serve for board...${c.reset}`);
+
+    try {
+      // Reset all tailscale serve config (no per-handler removal in the CLI)
+      await execa('tailscale', ['serve', 'reset']);
+      // Clear the AGX_BOARD_URL if it points to a tailscale URL
+      const boardEnv = loadBoardEnv();
+      if (boardEnv.AGX_BOARD_URL?.includes('.ts.net')) {
+        saveBoardEnvValue('AGX_BOARD_URL', '');
+      }
+      console.log(`${c.green}✓${c.reset} Tailscale Serve disabled`);
+      console.log(`  ${c.dim}Board is still accessible at http://localhost:${port}${c.reset}`);
+    } catch (err) {
+      console.log(`${c.red}✗${c.reset} Failed: ${err.message}`);
+      process.exit(1);
+    }
+
+    process.exit(0);
+  }
+
+  // ── share (enable) ─────────────────────────────────────────────
+  console.log(`${c.dim}Enabling Tailscale Serve for board...${c.reset}`);
+
+  try {
+    // Get Tailscale FQDN
+    const fqdn = await getTailscaleFqdn();
+    if (!fqdn) {
+      console.log(`${c.red}✗${c.reset} Could not get Tailscale hostname`);
+      console.log(`  ${c.dim}Make sure you're logged in: ${c.cyan}tailscale status${c.reset}`);
+      process.exit(1);
+    }
+
+    // Ensure board is running and verify it's healthy
+    await ensureBoardRunning();
+    const pid = isBoardRunning();
+    if (!pid) {
+      console.log(`${c.red}✗${c.reset} Board server failed to start`);
+      console.log(`  ${c.dim}Check logs with: ${c.cyan}agx board logs${c.reset}`);
+      process.exit(1);
+    }
+
+    // Start tailscale serve (proxies HTTPS to local port)
+    await execa('tailscale', ['serve', '--bg', String(port)]);
+
+    // Save the board URL
+    const boardUrl = `https://${fqdn}`;
+    saveBoardEnvValue('AGX_BOARD_URL', boardUrl);
+
+    console.log(`${c.green}✓${c.reset} Board is now accessible remotely`);
+    console.log(`\n  ${c.bold}URL:${c.reset} ${c.cyan}${boardUrl}${c.reset}`);
+    console.log(`\n${c.dim}Access from your phone or tablet by:${c.reset}`);
+    console.log(`  ${c.dim}1. Make sure your device is on the same Tailnet${c.reset}`);
+    console.log(`  ${c.dim}2. Open: ${boardUrl}${c.reset}`);
+    console.log(`\n${c.dim}To stop sharing:${c.reset} ${c.cyan}agx board share --off${c.reset}`);
+  } catch (err) {
+    console.log(`${c.red}✗${c.reset} Failed: ${err.message}`);
+    if (err.stderr) {
+      console.log(`  ${c.dim}${err.stderr.trim()}${c.reset}`);
+    }
+    console.log(`\n${c.dim}You may need admin/sudo privileges for 'tailscale serve'${c.reset}`);
+    process.exit(1);
+  }
+
+  process.exit(0);
+}
+
+module.exports = { handleBoardShare, isTailscaleServed };

package/lib/commands/daemonBoard.js

@@ -307,14 +307,17 @@ async function maybeHandleDaemonBoardCommand({ cmd, args, ctx }) {
       } else {
         console.log(`  ${c.dim}Canonical:${c.reset} agx board`);
       }
-      console.log(`  agx ${commandName} start        Start local UI server`);
-      console.log(`  agx ${commandName} stop         Stop local UI server`);
-      console.log(`  agx ${commandName} status       Show status`);
-      console.log(`  agx ${commandName} show         Print URL/log paths`);
-      console.log(`  agx ${commandName} open         Open UI in browser`);
-      console.log(`  agx ${commandName} logs         Show recent logs`);
-      console.log(`  agx ${commandName} tail         Live tail logs`);
-      console.log(`  agx ${commandName} start --no-open   Do not open browser`);
+      console.log(`  agx ${commandName} start            Start local UI server`);
+      console.log(`  agx ${commandName} stop             Stop local UI server`);
+      console.log(`  agx ${commandName} status           Show status`);
+      console.log(`  agx ${commandName} show             Print URL/log paths`);
+      console.log(`  agx ${commandName} open             Open UI in browser`);
+      console.log(`  agx ${commandName} logs             Show recent logs`);
+      console.log(`  agx ${commandName} tail             Live tail logs`);
+      console.log(`  agx ${commandName} share            Enable remote access via Tailscale`);
+      console.log(`  agx ${commandName} share --off      Disable remote access`);
+      console.log(`  agx ${commandName} share --status   Show remote access status`);
+      console.log(`  agx ${commandName} start --no-open  Do not open browser`);
       console.log(`  Env: AGX_NO_OPEN=1 (or AGX_BOARD_NO_OPEN=1)`);
       process.exit(0);
     } else if (subcmd === 'status') {
@@ -324,6 +327,14 @@ async function maybeHandleDaemonBoardCommand({ cmd, args, ctx }) {
         const healthy = await probeBoardHealth(port);
         console.log(`${c.green}Board server running${c.reset} (pid ${pid}, port ${port}${healthy ? ', healthy' : ', not responding'})`);
         console.log(`${c.dim}Logs: ${BOARD_LOG_FILE}${c.reset}`);
+        // Show Tailscale remote access status
+        try {
+          const { isTailscaleServed } = require('./board');
+          const isShared = await isTailscaleServed(port);
+          if (isShared) {
+            console.log(`${c.green}Remote access enabled${c.reset} via Tailscale`);
+          }
+        } catch { /* tailscale check is optional */ }
       } else {
         console.log(`${c.yellow}Board server not running${c.reset}`);
       }
@@ -360,9 +371,12 @@ async function maybeHandleDaemonBoardCommand({ cmd, args, ctx }) {
       const tail = execa('tail', ['-f', BOARD_LOG_FILE], { stdio: 'inherit', reject: false });
       tail.on('close', () => process.exit(0));
       return true;
+    } else if (subcmd === 'share') {
+      const { handleBoardShare } = require('./board');
+      await handleBoardShare({ args: args.slice(2), ctx });
     } else {
       console.log(`${c.red}Unknown ${commandName} command:${c.reset} ${subcmd}`);
-      console.log(`${c.dim}Usage: agx ${commandName} [start|stop|status|show|open|logs|tail]${c.reset}`);
+      console.log(`${c.dim}Usage: agx ${commandName} [start|stop|status|show|open|logs|tail|share]${c.reset}`);
       process.exit(0);
     }
     return true;