Skip to Content
kusaw docsv1.0.0
CLI reference

kusaw claude-args

Print or run the Claude Code argv the built-ins use

kusaw claude-args

Print or run the Claude Code argv the built-ins use

Usage

Text
kusaw claude-args --preset <edit|read_only|interview> [flags]

Flags

NameShortTypeDefaultDescription
--add-dirstringArrayDirectory passed as --add-dir (repeatable, order kept)
--configstringPath to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
--connectorsboolfalseMerge factory-connectors into --mcp-config when KUSAW_CONNECTOR_SOCKET is set
--execboolfalseRun the argv instead of printing it
--factorystringfactory name from kusaw list
--first-message-filestringInteractive first message file
--forkboolfalsePass --fork-session with --resume-session
--help-hboolfalsehelp for claude-args
--interactiveboolfalseBuild an interactive argv (interview only)
--modelstringPassed as --model when set
--presetstringedit, read_only, or interview
--protocol-eventsboolfalseTranslate stream-json to protocol v2 events (headless --exec only)
--repo-capabilitiesstringRepo label whose approved items isolation flags to add
--result-text-filestringWrite the session's final text here (needs --protocol-events)
--resume-sessionstringPass --resume so a custom step continues a session
--system-prompt-filestringFile sent as --append-system-prompt

Exit codes

CodeNameDescription
0okSuccess.
1errorRuntime error.
2usageUsage or validation error.
3rejectedControl request rejected; the error string is printed verbatim.
4not picked upControl request not picked up within the wait time while serve runs.

Example

Text
kusaw claude-args --preset interview --interactive --add-dir /tmp/demo

On this page