Function chat

extensions/cli/src/commands/chat.ts:546–641

(prompt?: string, options: ChatOptions = {})

}

export async function chat(prompt?: string, options: ChatOptions = {}) {
  // Configure logger based on headless mode
  configureLogger(options.headless ?? false);

  // Configure headless-aware logging system
  logging.configureLogger({ headless: options.headless ?? false });

  try {
    // Record session start
    telemetryService.recordSessionStart();

    // Start active time tracking
    telemetryService.startActiveTime();

    // Critical routing: Explicit separation of headless and interactive modes
    if (options.headless) {
      // Headless path - no Ink, no TUI, works in TTY-less environments
      logger.debug("Running in headless mode (TTY-less compatible)");
      await runHeadlessMode(prompt, options);
      return;
    }

    // Interactive path - requires TTY for Ink rendering
    // If not in headless mode, use unified initialization with TUI
    if (!options.headless) {
      // Process flags for TUI mode
      const { permissionOverrides } = processCommandFlags(options);
      // Initialize services with onboarding handled internally
      await initializeServices({
        options,
        headless: false,
        toolPermissionOverrides: permissionOverrides,
      });

      const agentFileState = await serviceContainer.get<AgentFileServiceState>(
        SERVICE_NAMES.AGENT_FILE,
      );

      const initialPrompt = prependPrompt(
        agentFileState?.agentFile?.prompt,
        prompt,
      );

      // Start TUI with skipOnboarding since we already handled it
      const tuiOptions: any = {
        initialPrompt,
        resume: options.resume,
        fork: options.fork,
        config: options.config,
        org: options.org,
        rule: options.rule,
        prompt: options.prompt,
        toolPermissionOverrides: permissionOverrides,
        skipOnboarding: true,
      };

      // If we detected piped input, create a custom stdin for TUI
      if ((options as any).hasPipedInput) {