@agentuity/cli 0.1.14 → 0.1.15

package/src/cmd/ai/opencode/install.ts

@@ -0,0 +1,120 @@
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { createSubcommand, type CommandContext } from '../../../types';
+import * as tui from '../../../tui';
+import { getCommand } from '../../../command-prefix';
+
+const OPENCODE_CONFIG_DIR = join(homedir(), '.config', 'opencode');
+const OPENCODE_CONFIG_FILE = join(OPENCODE_CONFIG_DIR, 'opencode.json');
+
+export const installSubcommand = createSubcommand({
+	name: 'install',
+	description: 'Install Agentuity Open Code plugin',
+	tags: ['fast'],
+	requires: { auth: true, apiClient: true, org: true },
+	examples: [
+		{
+			command: getCommand('ai opencode install'),
+			description: 'Install Agentuity Open Code plugin',
+		},
+	],
+	async handler(ctx: CommandContext<{ auth: true; apiClient: true; org: true }>) {
+		const { options, orgId } = ctx;
+		const jsonMode = !!options?.json;
+
+		if (!jsonMode) {
+			tui.newline();
+			tui.output(tui.bold('Installing Agentuity Open Code plugin'));
+			tui.newline();
+			tui.success(`Using organization: ${orgId}`);
+		}
+
+		const pluginEntry = '@agentuity/opencode';
+
+		// Update Open Code config if needed
+		let openCodeUpdated = false;
+		if (!existsSync(OPENCODE_CONFIG_DIR)) {
+			mkdirSync(OPENCODE_CONFIG_DIR, { recursive: true });
+		}
+
+		let openCodeConfig: { plugin?: string[]; $schema?: string } = {};
+		if (existsSync(OPENCODE_CONFIG_FILE)) {
+			try {
+				const content = readFileSync(OPENCODE_CONFIG_FILE, 'utf-8');
+				openCodeConfig = JSON.parse(content);
+			} catch {
+				openCodeConfig = {};
+			}
+		}
+
+		if (!openCodeConfig.plugin) {
+			openCodeConfig.plugin = [];
+		}
+
+		// Check if the exact plugin entry already exists
+		const hasExactEntry = openCodeConfig.plugin.includes(pluginEntry);
+
+		// Check if there's an existing entry that needs updating
+		const existingIndex = openCodeConfig.plugin.findIndex((p) => p === '@agentuity/opencode');
+
+		if (hasExactEntry) {
+			if (!jsonMode) {
+				tui.info('Open Code plugin already configured');
+			}
+		} else if (existingIndex >= 0) {
+			// Update existing entry to new value
+			openCodeConfig.plugin[existingIndex] = pluginEntry;
+			writeFileSync(OPENCODE_CONFIG_FILE, JSON.stringify(openCodeConfig, null, 2));
+			if (!jsonMode) {
+				tui.success(`Updated Open Code plugin to: ${pluginEntry}`);
+			}
+			openCodeUpdated = true;
+		} else {
+			// Add new entry
+			openCodeConfig.plugin.push(pluginEntry);
+			writeFileSync(OPENCODE_CONFIG_FILE, JSON.stringify(openCodeConfig, null, 2));
+			if (!jsonMode) {
+				tui.success(`Added ${pluginEntry} to Open Code config`);
+			}
+			openCodeUpdated = true;
+		}
+
+		// Summary (TUI only)
+		if (!jsonMode) {
+			tui.newline();
+			if (openCodeUpdated) {
+				tui.output(tui.bold('Agentuity Open Code plugin installed successfully!'));
+			} else {
+				tui.output(tui.bold('Agentuity Open Code plugin already installed'));
+			}
+
+			tui.newline();
+			tui.info('Next steps:');
+			tui.output(`  ${tui.ICONS.bullet} Start Open Code to use Agentuity Coder agents`);
+			tui.output(
+				`  ${tui.ICONS.bullet} Run ${tui.bold(getCommand('ai opencode run "<task>"'))} to execute tasks`
+			);
+			tui.newline();
+
+			tui.output(tui.muted('Recommended MCP servers for Scout/Expert agents:'));
+			tui.output(tui.muted('Add to your opencode.json:'));
+			tui.newline();
+			tui.output(tui.muted('  "mcp": {'));
+			tui.output(
+				tui.muted(
+					'    "context7": { "type": "remote", "url": "https://mcp.context7.com/mcp" },'
+				)
+			);
+			tui.output(
+				tui.muted('    "grep_app": { "type": "remote", "url": "https://mcp.grep.app" }')
+			);
+			tui.output(tui.muted('  }'));
+			tui.newline();
+		}
+
+		return { success: true, orgId };
+	},
+});
+
+export default installSubcommand;

package/src/cmd/ai/opencode/run.ts

@@ -0,0 +1,103 @@
+import { createSubcommand, type CommandContext } from '../../../types';
+import * as tui from '../../../tui';
+import { getCommand } from '../../../command-prefix';
+import { z } from 'zod';
+
+const RunArgsSchema = z.object({
+	task: z.string().describe('The task description to execute'),
+});
+
+const RunOptionsSchema = z.object({
+	sandbox: z.boolean().optional().describe('Run in a cloud sandbox environment'),
+	json: z.boolean().optional().describe('Output raw JSON events'),
+});
+
+export const runSubcommand = createSubcommand({
+	name: 'run',
+	description: 'Run a task with the Agentuity Coder agent team (non-interactive)',
+	tags: ['slow'],
+	requires: { auth: true },
+	schema: {
+		args: RunArgsSchema,
+		options: RunOptionsSchema,
+	},
+	examples: [
+		{
+			command: getCommand('ai opencode run "implement dark mode toggle"'),
+			description: 'Run a coding task',
+		},
+		{
+			command: getCommand('ai opencode run --sandbox "run the test suite"'),
+			description: 'Run in a cloud sandbox',
+		},
+		{
+			command: getCommand('ai opencode run --json "fix the bug"'),
+			description: 'Output raw JSON events',
+		},
+	],
+	async handler(
+		ctx: CommandContext<{ auth: true }, undefined, typeof RunArgsSchema, typeof RunOptionsSchema>
+	) {
+		const { logger, args, opts } = ctx;
+		const { task } = args;
+		const sandbox = opts?.sandbox;
+		const json = opts?.json;
+
+		if (!json) {
+			tui.newline();
+			tui.output(tui.bold('Agentuity Coder'));
+			tui.newline();
+			tui.output(`${tui.ICONS.arrow} Running task: ${task}`);
+			if (sandbox) {
+				tui.info('Sandbox mode enabled');
+			}
+			tui.newline();
+		}
+
+		const openCodeArgs = ['run', '--agent', 'Agentuity Coder Lead'];
+
+		if (json) {
+			openCodeArgs.push('--format', 'json');
+		}
+
+		// Build the task prompt with any mode prefixes
+		let taskPrompt = task;
+		if (sandbox) {
+			taskPrompt = `[SANDBOX MODE: Execute all code in an Agentuity cloud sandbox, not locally] ${taskPrompt}`;
+		}
+		if (json) {
+			taskPrompt = `[JSON OUTPUT: Your final response MUST be a valid JSON object with this structure: {"status": "success" | "failed" | "partial", "summary": "Brief description of what was done", "filesChanged": ["path/to/file.ts"], "errors": ["error message if any"], "payload": <any task-specific return data or null>}. Output ONLY the JSON, no other text.] ${taskPrompt}`;
+		}
+
+		openCodeArgs.push(taskPrompt);
+
+		logger.debug(`Spawning: opencode ${openCodeArgs.join(' ')}`);
+
+		const proc = Bun.spawn(['opencode', ...openCodeArgs], {
+			stdio: ['inherit', 'inherit', 'inherit'],
+			env: {
+				...process.env,
+				AGENTUITY_CODER_MODE: 'non-interactive',
+			},
+		});
+
+		const exitCode = await proc.exited;
+
+		// In JSON mode, let opencode's output speak for itself - exit code indicates success
+		if (json) {
+			process.exit(exitCode);
+		}
+
+		if (exitCode === 0) {
+			tui.newline();
+			tui.success('Task completed');
+		} else {
+			tui.newline();
+			tui.error(`Task failed with exit code ${exitCode}`);
+		}
+
+		return { success: exitCode === 0, task, exitCode, sandbox: !!sandbox };
+	},
+});
+
+export default runSubcommand;

package/src/cmd/ai/opencode/uninstall.ts

@@ -0,0 +1,90 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { createSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { getCommand } from '../../../command-prefix';
+
+const OPENCODE_CONFIG_DIR = join(homedir(), '.config', 'opencode');
+const OPENCODE_CONFIG_FILE = join(OPENCODE_CONFIG_DIR, 'opencode.json');
+
+export const uninstallSubcommand = createSubcommand({
+	name: 'uninstall',
+	description: 'Uninstall Agentuity Open Code plugin',
+	tags: ['fast'],
+	examples: [
+		{
+			command: getCommand('ai opencode uninstall'),
+			description: 'Uninstall Agentuity Open Code plugin',
+		},
+	],
+	async handler(ctx) {
+		const { options } = ctx;
+		const jsonMode = !!options?.json;
+
+		if (!jsonMode) {
+			tui.newline();
+			tui.output(tui.bold('Uninstalling Agentuity Open Code plugin'));
+			tui.newline();
+		}
+
+		let removedFromOpenCode = false;
+
+		// Remove from OpenCode config
+		if (!existsSync(OPENCODE_CONFIG_FILE)) {
+			if (!jsonMode) {
+				tui.info('Open Code config not found - nothing to uninstall');
+			}
+		} else {
+			try {
+				const content = readFileSync(OPENCODE_CONFIG_FILE, 'utf-8');
+				const openCodeConfig: { plugin?: string[]; $schema?: string } = JSON.parse(content);
+
+				if (!openCodeConfig.plugin || openCodeConfig.plugin.length === 0) {
+					if (!jsonMode) {
+						tui.info('No plugins configured in Open Code');
+					}
+				} else {
+					const originalLength = openCodeConfig.plugin.length;
+					openCodeConfig.plugin = openCodeConfig.plugin.filter(
+						(p) => p !== '@agentuity/opencode'
+					);
+
+					if (openCodeConfig.plugin.length < originalLength) {
+						writeFileSync(OPENCODE_CONFIG_FILE, JSON.stringify(openCodeConfig, null, 2));
+						if (!jsonMode) {
+							tui.success('Removed Agentuity Open Code plugin');
+						}
+						removedFromOpenCode = true;
+					} else {
+						if (!jsonMode) {
+							tui.info('Agentuity Open Code plugin not found');
+						}
+					}
+				}
+			} catch (error) {
+				if (!jsonMode) {
+					tui.warn(`Failed to parse Open Code config: ${error}`);
+				}
+			}
+		}
+
+		if (!jsonMode) {
+			tui.newline();
+
+			if (removedFromOpenCode) {
+				tui.output(tui.bold('Agentuity Open Code plugin uninstalled successfully'));
+			} else {
+				tui.output(tui.bold('Agentuity Open Code plugin was not installed'));
+			}
+
+			tui.newline();
+			tui.info(`To reinstall, run: ${tui.bold(getCommand('ai opencode install'))}`);
+			tui.newline();
+		}
+
+		return { success: true, removedFromOpenCode };
+	},
+});
+
+export default uninstallSubcommand;

package/src/cmd/build/vite/beacon-plugin.ts

@@ -104,7 +104,9 @@ export function beaconPlugin(options: BeaconPluginOptions): Plugin {
 					source: beaconCode,
 				});
 			} catch (error) {
-				this.error(`Failed to read beacon script: ${error instanceof Error ? error.message : String(error)}`);
+				this.error(
+					`Failed to read beacon script: ${error instanceof Error ? error.message : String(error)}`
+				);
 			}
 		},
 

package/src/cmd/build/vite/vite-builder.ts

@@ -142,7 +142,11 @@ export async function runViteBuild(options: ViteBuildOptions): Promise<void> {
 		const htmlPath = join(rootDir, 'src', 'web', 'index.html');
 
 		// Use workbench config passed from runAllBuilds
-		const { workbenchEnabled = false, workbenchRoute = '/workbench', analyticsEnabled = false } = options;
+		const {
+			workbenchEnabled = false,
+			workbenchRoute = '/workbench',
+			analyticsEnabled = false,
+		} = options;
 
 		// Load custom user plugins from agentuity.config.ts if it exists
 		const clientOutDir = join(rootDir, '.agentuity/client');

package/src/cmd/project/create.ts

@@ -6,6 +6,7 @@ import type { APIClient as APIClientType } from '../../api';
 
 const ProjectCreateResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
+	error: z.string().optional().describe('Error message if setup failed'),
 	name: z.string().describe('Project name'),
 	path: z.string().describe('Project directory path'),
 	projectId: z.string().optional().describe('Project ID if registered'),
@@ -73,7 +74,7 @@ export const createProjectSubcommand = createSubcommand({
 	},
 
 	async handler(ctx) {
-		const { logger, opts, auth, config, apiClient, region } = ctx;
+		const { logger, opts, auth, config, apiClient, region, options } = ctx;
 
 		// Only get org if registering
 		let orgId: string | undefined;
@@ -102,8 +103,14 @@ export const createProjectSubcommand = createSubcommand({
 			region,
 		});
 
+		// Exit with error code if setup failed and not in JSON mode
+		if (!result.success && !options.json) {
+			process.exitCode = 1;
+		}
+
 		return {
-			success: true,
+			success: result.success,
+			error: result.error,
 			name: result.name,
 			path: result.path,
 			projectId: result.projectId,

package/src/cmd/project/download.ts

@@ -328,8 +328,9 @@ export async function downloadTemplate(options: DownloadOptions): Promise<void>
 	}
 }
 
-export async function setupProject(options: SetupOptions): Promise<void> {
+export async function setupProject(options: SetupOptions): Promise<{ success: boolean }> {
 	const { dest, projectName, dirName, noInstall, noBuild, logger } = options;
+	let hasError = false;
 
 	// Replace {{PROJECT_NAME}} in files
 	tui.info(`🔧 Setting up ${projectName}...`);
@@ -345,6 +346,7 @@ export async function setupProject(options: SetupOptions): Promise<void> {
 		});
 		if (exitCode !== 0) {
 			logger.error('Failed to install dependencies');
+			hasError = true;
 		}
 	}
 
@@ -361,6 +363,7 @@ export async function setupProject(options: SetupOptions): Promise<void> {
 			});
 			if (exitCode !== 0) {
 				logger.error('Template setup script failed');
+				hasError = true;
 			}
 		} finally {
 			// Always delete the setup script after running (or attempting to run)
@@ -382,12 +385,15 @@ export async function setupProject(options: SetupOptions): Promise<void> {
 		});
 		if (exitCode !== 0) {
 			logger.error('Failed to build project');
+			hasError = true;
 		}
 	}
 
 	// Generate and write AGENTS.md files for the CLI and source folders
 	// Always overwrite during project setup to ensure fresh content
 	await writeAgentsDocs(dest);
+
+	return { success: !hasError };
 }
 
 export async function initGitRepo(dest: string): Promise<void> {

package/src/cmd/project/template-flow.ts

@@ -66,6 +66,8 @@ export interface CreateFlowResult {
 	installed: boolean;
 	built: boolean;
 	domains?: string[];
+	success: boolean;
+	error?: string;
 }
 
 export async function runCreateFlow(options: CreateFlowOptions): Promise<CreateFlowResult> {
@@ -249,7 +251,7 @@ export async function runCreateFlow(options: CreateFlowOptions): Promise<CreateF
 	});
 
 	// Setup project (replace placeholders, install deps, build)
-	await setupProject({
+	const setupResult = await setupProject({
 		dest,
 		projectName: projectName === '.' ? basename(dest) : projectName,
 		dirName: dirName === '.' ? basename(dest) : dirName,
@@ -258,15 +260,24 @@ export async function runCreateFlow(options: CreateFlowOptions): Promise<CreateF
 		logger,
 	});
 
-	// Re-display template selection after spinners clear it (only if user actually selected)
-	if (!skipPrompts && templates.length > 1) {
+	// If setup failed, skip resource prompts and registration - just show error and return
+	if (!setupResult.success) {
+		tui.warning('Project setup failed. Skipping resource configuration.');
+		return {
+			name: projectName,
+			path: dest,
+			template: selectedTemplate.id,
+			installed: !options.noInstall,
+			built: false,
+			success: false,
+			error: 'Project setup completed with errors',
+		};
+	}
+
+	// Add separator bar if we're going to show resource prompts
+	if (!skipPrompts && auth && apiClient && catalystClient && orgId && region) {
 		const { symbols, tuiColors } = tui;
-		console.log(`${tuiColors.completed(symbols.completed)}  Select a template:`);
-		console.log(`${tuiColors.secondary(symbols.bar)}  ${tuiColors.muted(selectedTemplate.name)}`);
-		// Only add bar if we're going to show resource prompts
-		if (auth && apiClient && catalystClient && orgId && region) {
-			console.log(tuiColors.secondary(symbols.bar));
-		}
+		console.log(tuiColors.secondary(symbols.bar));
 	}
 
 	let _domains = domains;
@@ -597,7 +608,11 @@ export async function runCreateFlow(options: CreateFlowOptions): Promise<CreateF
 
 	// Show completion message
 	if (!skipPrompts) {
-		tui.success('✨ Project created successfully!\n');
+		if (setupResult.success) {
+			tui.success('✨ Project created successfully!\n');
+		} else {
+			tui.warning('Project created with errors (see above)\n');
+		}
 
 		// Show next steps in a box with primary color for commands
 		if (dirName !== '.') {
@@ -617,7 +632,11 @@ export async function runCreateFlow(options: CreateFlowOptions): Promise<CreateF
 			`${tui.tuiColors.muted('⭐️ Follow us:')} ${tui.link('https://github.com/agentuity/sdk')}`
 		);
 	} else {
-		tui.success('✨ Project created successfully!');
+		if (setupResult.success) {
+			tui.success('✨ Project created successfully!');
+		} else {
+			tui.warning('Project created with errors');
+		}
 	}
 
 	playSound();
@@ -643,8 +662,10 @@ export async function runCreateFlow(options: CreateFlowOptions): Promise<CreateF
 		path: dest,
 		template: selectedTemplate.id,
 		installed: !options.noInstall,
-		built: !options.noBuild,
+		built: !options.noBuild && setupResult.success,
 		domains: _domains,
+		success: setupResult.success,
+		error: setupResult.success ? undefined : 'Project setup completed with errors',
 	};
 }
 

package/src/tui/prompt.ts

@@ -166,9 +166,16 @@ export class PromptFlow {
 				readline.moveCursor(process.stdout, 0, -linesToClear);
 				readline.clearScreenDown(process.stdout);
 
-				process.stdout.write(
-					`${colors.completed(symbols.completed)}  ${message}\n${colors.secondary(symbols.bar)}  ${colors.muted(value)}\n${colors.secondary(symbols.bar)}\n`
-				);
+				// If value is empty, only show message and separator (no value line)
+				if (value === '') {
+					process.stdout.write(
+						`${colors.completed(symbols.completed)}  ${message}\n${colors.secondary(symbols.bar)}\n`
+					);
+				} else {
+					process.stdout.write(
+						`${colors.completed(symbols.completed)}  ${message}\n${colors.secondary(symbols.bar)}  ${colors.muted(value)}\n${colors.secondary(symbols.bar)}\n`
+					);
+				}
 
 				this.states.push({
 					type: 'completed',