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

38 lines
1.6 KiB
Markdown

---
status: active
system: cli
created: 2026-09-03
owners:
- 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.