Files
kandev/docs/specs/cli/requirements/passthrough-launch-defaults.md
T
2026-09-04 02:16:10 +00:00

1.6 KiB

status, system, created, owners
status system created owners
active cli 2026-09-03
kandev

Passthrough Launch Defaults Requirements

Overview

CLI passthrough gives users the native interactive output of an agent. Built-in launch arguments must preserve that standard output unless a profile selects a different mode.

Requirements

REQ-CLI-PASSTHROUGH-LAUNCH-001: Keep diagnostic output optional

Intent: A user can operate Claude CLI passthrough without forced diagnostic output. The user can enable diagnostic output for a selected profile.

Acceptance criteria

  • AC-CLI-PASSTHROUGH-LAUNCH-001.1: When Kandev starts built-in Claude CLI passthrough without an enabled --verbose profile flag, the launched command shall omit --verbose.
  • AC-CLI-PASSTHROUGH-LAUNCH-001.2: When the Claude profile contains an enabled --verbose CLI flag, the launched passthrough command shall include --verbose.
  • AC-CLI-PASSTHROUGH-LAUNCH-001.3: The quiet default shall preserve model selection, permission flags, session resume, prompt delivery, and MCP configuration.
  • AC-CLI-PASSTHROUGH-LAUNCH-001.4: Existing profiles shall require no data migration. A user can add --verbose through the existing CLI-flags field.
  • AC-CLI-PASSTHROUGH-LAUNCH-001.5: When a profile contains enabled CLI flags, the passthrough command preview shall show the same flags that the launched command receives.

Out of scope

  • A dedicated verbose-output setting.
  • Changes to Claude ACP execution.
  • Changes to the launch defaults of other agents.
  • Changes to Claude Code output rendering.