@guildai/cli 0.10.0 → 0.11.0

package/dist/commands/integration/operation/list.js

@@ -5,7 +5,7 @@ import chalk from 'chalk';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAuthToken } from '../../../lib/auth.js';
 import { handleAxiosError } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter } from '../../../lib/output.js';
 import { resolveVersionId } from '../../../lib/integration-helpers.js';
 import { Table } from '../../../lib/table.js';
@@ -32,7 +32,7 @@ export function createIntegrationOperationListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/integration_versions/${versionId}/endpoints?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/integration/update.js

@@ -5,7 +5,7 @@ import chalk from 'chalk';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter } from '../../lib/output.js';
 function formatUpdatedIntegration(integration) {
     console.log(chalk.green('Integration updated successfully'));
@@ -121,7 +121,7 @@ export function createIntegrationUpdateCommand() {
                 process.exit(1);
             }
             const response = await client.patch(`/integrations/${identifier}`, body);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/integration/version/build.js

@@ -5,7 +5,7 @@ import chalk from 'chalk';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAuthToken } from '../../../lib/auth.js';
 import { handleAxiosError } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter } from '../../../lib/output.js';
 import { createSpinner } from '../../../lib/progress.js';
 import { resolveLatestDraftId } from '../../../lib/integration-helpers.js';
@@ -36,7 +36,7 @@ export function createIntegrationVersionBuildCommand() {
             const buildResponse = await client.post(`/integration_versions/${versionId}/build`, {
                 version_number: options.versionNumber,
             });
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(buildResponse);
                 return;
             }

package/dist/commands/integration/version/create.js

@@ -5,7 +5,7 @@ import chalk from 'chalk';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAuthToken } from '../../../lib/auth.js';
 import { handleAxiosError } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter } from '../../../lib/output.js';
 export function createIntegrationVersionCreateCommand() {
     const cmd = new Command('create');
@@ -22,7 +22,7 @@ export function createIntegrationVersionCreateCommand() {
             }
             const client = new GuildAPIClient();
             const response = await client.post(`/integrations/${identifier}/versions`, {});
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/integration/version/get.js

@@ -5,7 +5,7 @@ import chalk from 'chalk';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAuthToken } from '../../../lib/auth.js';
 import { handleAxiosError } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter } from '../../../lib/output.js';
 import { resolveVersionId } from '../../../lib/integration-helpers.js';
 function formatDate(dateStr) {
@@ -46,7 +46,7 @@ export function createIntegrationVersionGetCommand() {
             const client = new GuildAPIClient();
             const versionId = await resolveVersionId(client, identifier, options.versionNumber);
             const response = await client.get(`/integration_versions/${versionId}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/integration/version/list.js

@@ -4,7 +4,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAuthToken } from '../../../lib/auth.js';
 import { handleAxiosError } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter, formatIntegrationVersionTable, } from '../../../lib/output.js';
 import { DEFAULT_PAGE_LIMIT } from '../../../lib/api-types.js';
 export function createIntegrationVersionListCommand() {
@@ -27,7 +27,7 @@ export function createIntegrationVersionListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/integrations/${identifier}/versions?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/integration/version/publish.js

@@ -5,7 +5,7 @@ import chalk from 'chalk';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAuthToken } from '../../../lib/auth.js';
 import { handleAxiosError } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter } from '../../../lib/output.js';
 import { createSpinner } from '../../../lib/progress.js';
 import { resolveVersionId } from '../../../lib/integration-helpers.js';
@@ -38,7 +38,7 @@ export function createIntegrationVersionPublishCommand() {
             const currentVersion = await client.get(`/integration_versions/${versionId}`);
             const versionDisplay = currentVersion.version_number || versionId;
             const publishResponse = await client.post(`/integration_versions/${versionId}/publish`, {});
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(publishResponse);
                 return;
             }

package/dist/commands/integration/version/test.js

@@ -5,7 +5,7 @@ import chalk from 'chalk';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { getAuthToken } from '../../../lib/auth.js';
 import { handleAxiosError } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter } from '../../../lib/output.js';
 import { resolveVersionId } from '../../../lib/integration-helpers.js';
 function parseJsonFlag(value, flagName) {
@@ -60,7 +60,7 @@ export function createIntegrationVersionTestCommand() {
                 body.credential_id = creds.items[0].id;
             }
             const response = await client.post(`/integration_versions/${versionId}/test`, body);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/job/get.js

@@ -4,7 +4,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatJobStepTable } from '../../lib/output.js';
 export function createJobGetCommand() {
     const cmd = new Command('get');
@@ -24,7 +24,7 @@ export function createJobGetCommand() {
                 client.get(`/jobs/${jobId}`),
                 client.get(`/jobs/${jobId}/steps`),
             ]);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 console.log(JSON.stringify({ ...job, steps: stepsResponse.steps }, null, 2));
             }
             else {

package/dist/commands/session/list.js

@@ -5,7 +5,7 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { getWorkspaceId } from '../../lib/guild-config.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatSessionTable } from '../../lib/output.js';
 import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createSessionListCommand() {
@@ -41,7 +41,7 @@ export function createSessionListCommand() {
                 params.append('types', options.type.toLowerCase());
             }
             const response = await client.get(`/workspaces/${workspaceId}/sessions?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 console.log(JSON.stringify(response, null, 2));
             }
             else {

package/dist/commands/session/tasks.js

@@ -4,7 +4,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatTaskTable } from '../../lib/output.js';
 import { DEFAULT_PAGE_LIMIT_LARGE } from '../../lib/api-types.js';
 export function createSessionTasksCommand() {
@@ -27,7 +27,7 @@ export function createSessionTasksCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/sessions/${sessionId}/tasks?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 console.log(JSON.stringify(response, null, 2));
             }
             else {

package/dist/commands/setup.d.ts

@@ -1,3 +1,19 @@
 import { Command } from 'commander';
+/**
+ * Run setup in a target directory. Exported so init/clone can call it.
+ * When called with `quiet: true`, suppresses progress output (used as a
+ * post-init/clone step where the caller handles its own progress UI).
+ */
+export declare function runSetup(targetDir: string, options?: {
+    force?: boolean;
+    claudeMd?: boolean;
+    codex?: boolean;
+    agentsMd?: boolean;
+    mcp?: boolean;
+    quiet?: boolean;
+}): Promise<{
+    filesCreated: number;
+    filesSkipped: number;
+}>;
 export declare function createSetupCommand(): Command;
 //# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.js

@@ -79,9 +79,9 @@ const MCP_SERVER_CONFIG = {
     command: 'guild',
     args: ['mcp'],
 };
-async function setupMcp(options) {
+async function setupMcp(targetDir, options) {
     const output = createOutputWriter();
-    const mcpPath = path.join(process.cwd(), '.mcp.json');
+    const mcpPath = path.join(targetDir, '.mcp.json');
     let existing = {};
     const exists = await fileExists(mcpPath);
     if (exists) {
@@ -108,55 +108,74 @@ async function setupMcp(options) {
     }
     return 'created';
 }
-async function setup(options) {
+/**
+ * Run setup in a target directory. Exported so init/clone can call it.
+ * When called with `quiet: true`, suppresses progress output (used as a
+ * post-init/clone step where the caller handles its own progress UI).
+ */
+export async function runSetup(targetDir, options = {}) {
     const output = createOutputWriter();
-    if (options.agentsMd && !options.codex) {
+    const force = options.force ?? false;
+    const claudeMd = options.claudeMd ?? false;
+    const codex = options.codex ?? false;
+    const agentsMd = options.agentsMd ?? false;
+    const mcp = options.mcp ?? true;
+    const quiet = options.quiet ?? false;
+    if (agentsMd && !codex) {
         output.error('--agents-md requires --codex', 'Create Codex setup files with:\n  guild setup --codex --agents-md');
         process.exit(1);
     }
-    if (options.claudeMd && options.codex) {
+    if (claudeMd && codex) {
         output.error('--claude-md cannot be used with --codex', 'Create Claude setup with:\n  guild setup --claude-md\n\nCreate Codex setup with:\n  guild setup --codex --agents-md');
         process.exit(1);
     }
-    const skillFiles = options.codex ? CODEX_SKILL_FILES : CLAUDE_SKILL_FILES;
+    const skillFiles = codex ? CODEX_SKILL_FILES : CLAUDE_SKILL_FILES;
     // Verify source docs exist
     for (const file of skillFiles) {
         if (!(await fileExists(file.src))) {
-            output.error('Could not find Guild CLI docs. Reinstall the CLI: npm install -g @guildai/cli');
-            process.exit(1);
+            if (!quiet) {
+                output.error('Could not find Guild CLI docs. Reinstall the CLI: npm install -g @guildai/cli');
+            }
+            return { filesCreated: 0, filesSkipped: 0 };
         }
     }
-    output.progress('Setting up Guild CLI skills...');
-    output.progress('');
+    if (!quiet) {
+        output.progress('Setting up Guild CLI skills...');
+        output.progress('');
+    }
     let filesCreated = 0;
     let filesSkipped = 0;
     let codexProjectFilesChanged = false;
     // Copy skill files
     for (const file of skillFiles) {
-        const destPath = path.join(process.cwd(), file.dest);
+        const destPath = path.join(targetDir, file.dest);
         const exists = await fileExists(destPath);
-        if (exists && !options.force) {
-            output.progress(`${file.label} already exists (use --force to overwrite)`);
+        if (exists && !force) {
+            if (!quiet) {
+                output.progress(`${file.label} already exists (use --force to overwrite)`);
+            }
             filesSkipped++;
         }
         else {
             await fs.mkdir(path.dirname(destPath), { recursive: true });
             await fs.copyFile(file.src, destPath);
-            if (exists) {
-                output.success(`Updated ${file.label}`);
-            }
-            else {
-                output.success(`Created ${file.label}`);
+            if (!quiet) {
+                if (exists) {
+                    output.success(`Updated ${file.label}`);
+                }
+                else {
+                    output.success(`Created ${file.label}`);
+                }
             }
             filesCreated++;
-            if (options.codex) {
+            if (codex) {
                 codexProjectFilesChanged = true;
             }
         }
     }
-    // Handle --mcp flag
-    if (options.mcp) {
-        const result = await setupMcp({ force: options.force });
+    // Handle MCP config
+    if (mcp) {
+        const result = await setupMcp(targetDir, { force });
         if (result === 'created') {
             filesCreated++;
         }
@@ -165,53 +184,64 @@ async function setup(options) {
         }
     }
     // Handle CLAUDE.md template
-    if (options.claudeMd) {
-        const claudeMdPath = path.join(process.cwd(), 'CLAUDE.md');
+    if (claudeMd) {
+        const claudeMdPath = path.join(targetDir, 'CLAUDE.md');
         const exists = await fileExists(claudeMdPath);
         if (exists) {
-            output.progress('CLAUDE.md already exists (not overwriting)');
+            if (!quiet) {
+                output.progress('CLAUDE.md already exists (not overwriting)');
+            }
             filesSkipped++;
         }
         else {
             await fs.writeFile(claudeMdPath, CLAUDE_MD_TEMPLATE, 'utf-8');
-            output.success('Created CLAUDE.md');
+            if (!quiet) {
+                output.success('Created CLAUDE.md');
+            }
             filesCreated++;
         }
     }
     // Handle AGENTS.md template for Codex setup
-    if (options.agentsMd) {
-        const agentsMdPath = path.join(process.cwd(), 'AGENTS.md');
+    if (agentsMd) {
+        const agentsMdPath = path.join(targetDir, 'AGENTS.md');
         const exists = await fileExists(agentsMdPath);
         if (exists) {
-            output.progress('AGENTS.md already exists (not overwriting)');
+            if (!quiet) {
+                output.progress('AGENTS.md already exists (not overwriting)');
+            }
             filesSkipped++;
         }
         else {
             await fs.writeFile(agentsMdPath, AGENTS_MD_TEMPLATE, 'utf-8');
-            output.success('Created AGENTS.md');
+            if (!quiet) {
+                output.success('Created AGENTS.md');
+            }
             filesCreated++;
             codexProjectFilesChanged = true;
         }
     }
-    // Summary
-    output.progress('');
-    if (filesCreated > 0 && filesSkipped === 0) {
-        if (options.force) {
-            output.success('Guild CLI skills updated.');
+    // Summary (only in standalone mode)
+    if (!quiet) {
+        output.progress('');
+        if (filesCreated > 0 && filesSkipped === 0) {
+            if (force) {
+                output.success('Guild CLI skills updated.');
+            }
+            else {
+                output.success('Guild CLI skills installed. Your coding assistant can now drive agent development.');
+            }
+        }
+        else if (filesCreated === 0) {
+            output.progress('No files were modified. Use --force to overwrite existing files.');
         }
         else {
-            output.success('Guild CLI skills installed. Your coding assistant can now drive agent development.');
+            output.success('Guild CLI skills installed.');
+        }
+        if (codexProjectFilesChanged) {
+            output.progress('Restart Codex to pick up the new project instructions.');
         }
     }
-    else if (filesCreated === 0) {
-        output.progress('No files were modified. Use --force to overwrite existing files.');
-    }
-    else {
-        output.success('Guild CLI skills installed.');
-    }
-    if (codexProjectFilesChanged) {
-        output.progress('Restart Codex to pick up the new project instructions.');
-    }
+    return { filesCreated, filesSkipped };
 }
 export function createSetupCommand() {
     const cmd = new Command('setup');
@@ -223,7 +253,7 @@ export function createSetupCommand() {
         .option('--agents-md', 'With --codex, also create an AGENTS.md template in the project root', false)
         .option('--no-mcp', 'Skip MCP server configuration')
         .action(async (options) => {
-        await setup(options);
+        await runSetup(process.cwd(), options);
     });
     return cmd;
 }

package/dist/commands/trigger/list.js

@@ -5,7 +5,7 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { getWorkspaceId } from '../../lib/guild-config.js';
 import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatTriggerTable } from '../../lib/output.js';
 import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createTriggerListCommand() {
@@ -39,7 +39,7 @@ export function createTriggerListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/workspaces/${workspaceId}/triggers?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 console.log(JSON.stringify(response, null, 2));
             }
             else {

package/dist/commands/workspace/agent/list.js

@@ -6,7 +6,7 @@ import { getAuthToken } from '../../../lib/auth.js';
 import { getWorkspaceId } from '../../../lib/guild-config.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
 import { createOutputWriter, formatWorkspaceAgentTable } from '../../../lib/output.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { resolveWorkspaceId } from '../../../lib/workspace-helpers.js';
 import { DEFAULT_PAGE_LIMIT } from '../../../lib/api-types.js';
 export function createWorkspaceAgentListCommand() {
@@ -52,7 +52,7 @@ export function createWorkspaceAgentListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/workspaces/${workspaceId}/workspace_agents?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/workspace/context/list.js

@@ -3,7 +3,7 @@
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
-import { getOutputMode } from '../../../lib/output-mode.js';
+import { isMachineReadable } from '../../../lib/output-mode.js';
 import { createOutputWriter, formatContextTable } from '../../../lib/output.js';
 import { DEFAULT_PAGE_LIMIT } from '../../../lib/api-types.js';
 export function createWorkspaceContextListCommand() {
@@ -21,7 +21,7 @@ export function createWorkspaceContextListCommand() {
             params.append('limit', options.limit);
             params.append('offset', options.offset);
             const response = await client.get(`/workspaces/${workspaceId}/contexts?${params.toString()}`);
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 output.data(response);
             }
             else {

package/dist/commands/workspace/list.js

@@ -3,7 +3,7 @@
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
+import { isMachineReadable } from '../../lib/output-mode.js';
 import { createOutputWriter, formatWorkspaceTable } from '../../lib/output.js';
 import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createWorkspaceListCommand() {
@@ -44,7 +44,7 @@ export function createWorkspaceListCommand() {
                 params.append('offset', options.offset);
                 response = await client.get(`/me/workspaces?${params.toString()}`);
             }
-            if (getOutputMode() === 'json') {
+            if (isMachineReadable()) {
                 console.log(JSON.stringify(response, null, 2));
             }
             else {

package/dist/index.js

@@ -24,6 +24,7 @@ import { createAgentForkCommand } from './commands/agent/fork.js';
 import { createAgentPublishCommand } from './commands/agent/publish.js';
 import { createAgentUnpublishCommand } from './commands/agent/unpublish.js';
 import { createAgentRevalidateCommand } from './commands/agent/revalidate.js';
+import { createAgentLogsCommand } from './commands/agent/logs.js';
 import { createAgentSearchCommand } from './commands/agent/search.js';
 import { createAgentOwnersCommand } from './commands/agent/owners.js';
 import { createAgentWorkspacesCommand } from './commands/agent/workspaces.js';
@@ -111,8 +112,11 @@ program
     .description('Guild.ai CLI - Build, test, and deploy AI agents')
     .version(packageJson.version)
     .option('--debug', 'Enable debug mode with verbose logging')
-    .option('--json', 'Output pure JSON format (non-interactive)')
+    .option('--mode <format>', 'Output format: interactive (default), json, or jsonl')
+    // Backward compat: --json is a hidden alias for --mode json
+    .addOption(new Option('--json').default(false).hideHelp())
     .option('--quiet, -q', 'Suppress progress and log messages')
+    .option('--non-interactive', 'Disable interactive prompts (for CI, scripts, and coding agents)')
     // Dev shortcuts — hidden from help, use env vars GUILD_USE_SHARED / GUILD_USE_LOCAL instead
     .addOption(new Option('--shared').default(false).hideHelp())
     .addOption(new Option('--local').default(false).hideHelp())
@@ -135,11 +139,13 @@ program
     .argument('[prompt...]', 'Optional initial prompt (multiple words)')
     .option('--agent <identifier>', 'Agent ID or full name, e.g., foo~bar (default: assistant)')
     .option('--once', 'One-shot mode: send message, wait for response, exit (non-interactive)')
-    .option('--mode <format>', 'Machine-readable output format: json or jsonl')
     .option('--workspace <identifier>', 'Workspace ID or full name (e.g., owner/workspace-name)')
     .option('--no-splash', 'Skip the splash screen animation')
     .option('--resume <session-id>', 'Resume an existing session')
     .option('--events <types>', 'Event types to show (default: user). Shorthands: none, user, system, all, or comma-separated type names (e.g. agent_console,llm_start)')
+    // Accept --mode here so `guild chat --mode json` doesn't error.
+    // The actual value is read from process.argv by getOutputMode().
+    .addOption(new Option('--mode <format>').hideHelp())
     .addHelpText('after', '\nTo chat with a local agent under development: guild agent chat')
     .action(async (promptArgs, options) => {
     const { handleChatAction } = await import('./commands/chat.js');
@@ -170,12 +176,14 @@ agentCmd
     .argument('[prompt...]', 'Optional initial prompt for the agent')
     .option('--path <dir>', 'Path to agent directory (defaults to current directory)')
     .option('--workspace <identifier>', 'Workspace ID or full name (e.g., owner~workspace-name)')
-    .option('--mode <format>', 'Input mode: json (one-shot) or jsonl (line-by-line)')
     .option('--agent-version <id>', 'Chat with a specific version (UUID or version number)')
     .option('--no-splash', 'Skip the splash screen animation')
     .option('--resume <session-id>', 'Resume an existing session')
     .option('--open', 'Open session in web dashboard')
     .option('--no-cache', 'Skip ephemeral build cache (force a fresh build)')
+    // Accept --mode here so `guild agent chat --mode json` doesn't error.
+    // The actual value is read from process.argv by getOutputMode().
+    .addOption(new Option('--mode <format>').hideHelp())
     .addHelpText('after', '\nTo chat with a published agent by name: guild chat --agent owner~agent-name')
     .action(async (promptArgs, options) => {
     const { handleAgentChatAction } = await import('./commands/agent/chat.js');
@@ -190,13 +198,15 @@ agentCmd
     .command('test')
     .description('Test agent in interactive REPL session')
     .option('--workspace <identifier>', 'Workspace ID or full name (e.g., owner/workspace-name)')
-    .option('--mode <format>', 'Input mode: json (one-shot) or jsonl (line-by-line)')
     .option('--agent-version <id>', 'Test a specific version (UUID or version number)')
     .option('--resume <session-id>', 'Resume an existing test session')
     .option('--open', 'Open session in web dashboard')
     .option('--events <types>', 'Event types to stream (default: all). Shorthands: none, user, system, all, or comma-separated type names')
     .option('--bundle <file>', 'Path to a pre-built gzip+base64 bundle file')
     .option('--no-cache', 'Skip ephemeral build cache (force a fresh build)')
+    // Accept --mode here so `guild agent test --mode json` doesn't error.
+    // The actual value is read from process.argv by getOutputMode().
+    .addOption(new Option('--mode <format>').hideHelp())
     .action(async (options) => {
     const { handleAgentTestAction } = await import('./commands/agent/test.js');
     await handleAgentTestAction(options);
@@ -204,6 +214,7 @@ agentCmd
 agentCmd.addCommand(createAgentPublishCommand());
 agentCmd.addCommand(createAgentUnpublishCommand());
 agentCmd.addCommand(createAgentRevalidateCommand());
+agentCmd.addCommand(createAgentLogsCommand());
 agentCmd.addCommand(createAgentSearchCommand());
 agentCmd.addCommand(createAgentOwnersCommand());
 agentCmd.addCommand(createAgentWorkspacesCommand());

package/dist/lib/auth.d.ts

@@ -46,7 +46,7 @@ export declare function pollForToken(authUrl: string, code: string, interval: nu
  * @param returnLabel - Optional friendly label for return button (e.g., "VSCode")
  * @returns true if successful, false otherwise
  */
-export declare function login(returnUrl?: string, returnLabel?: string, nonInteractive?: boolean): Promise<boolean>;
+export declare function login(returnUrl?: string, returnLabel?: string): Promise<boolean>;
 /**
  * Perform logout
  */

package/dist/lib/auth.js

@@ -191,12 +191,12 @@ export async function pollForToken(authUrl, code, interval) {
  * @param returnLabel - Optional friendly label for return button (e.g., "VSCode")
  * @returns true if successful, false otherwise
  */
-export async function login(returnUrl, returnLabel, nonInteractive) {
+export async function login(returnUrl, returnLabel) {
     const authUrl = getGuildcoreUrl();
     try {
         console.log(chalk.bold('\nGuild.ai Authentication'));
         const deviceCode = await startDeviceFlow(authUrl, returnUrl, returnLabel);
-        const skipBrowser = nonInteractive || !isInteractive();
+        const skipBrowser = !isInteractive();
         if (skipBrowser) {
             console.log(`\nVerification code: ${deviceCode.user_code}`);
             console.log(`Open to authenticate: ${deviceCode.verification_uri_complete}\n`);

package/dist/lib/output-mode.d.ts

@@ -1,11 +1,18 @@
-export type OutputMode = 'interactive' | 'json';
+export type OutputMode = 'interactive' | 'json' | 'jsonl';
 /**
  * Detect output mode from CLI flags or config
  *
- * Checks --json flag and config. CLI flag overrides config.
+ * Priority: --mode <value> > --json (backward compat) > config
  * Does NOT auto-detect pipes (user must request JSON explicitly).
  */
 export declare function getOutputMode(): OutputMode;
+/**
+ * Check if the current output mode is machine-readable (json or jsonl).
+ *
+ * Use this in list/get commands instead of `getOutputMode() === 'json'`
+ * so that both --mode json and --mode jsonl trigger non-interactive output.
+ */
+export declare function isMachineReadable(): boolean;
 /**
  * Check if quiet mode is enabled (CLI flag or config)
  *