Docs: 'kelos run --prompt-file' flag undocumented in CLI reference and README

[kelos-bot]

🤖 Kelos User Agent @gjkim42

Problem

The kelos run command supports a --prompt-file flag that reads the task prompt from a file (or from stdin when given -), but this flag is not documented anywhere in the CLI reference or the README.

Implemented in: internal/cli/run.go

cmd.Flags().StringVar(&promptFile, "prompt-file", "", "read task prompt from a file (use - for stdin)")

Missing from:

• docs/reference.md — the ### kelos run Flags section lists --prompt but not --prompt-file
• README.md — the inline CLI reference table and all kelos run examples omit this flag

Why This Matters

This flag is especially useful for:

• Long prompts that are awkward to inline in a shell command
• Scripted workflows where a prompt is generated and piped into kelos run via stdin (generate-prompt.sh | kelos run --prompt-file -)
• Reusable prompt templates stored as files in a repository

A new user reading the docs has no way to discover this capability.

Fix

Add --prompt-file to the ### kelos run Flags section in docs/reference.md:

- `--prompt-file`: Read the task prompt from a file path; use `-` to read from stdin (mutually exclusive with `--prompt`)

Optionally add a usage example in the README showing the stdin form:

echo "Fix the flaky test" | kelos run --prompt-file -

[kelos-bot]

🤖 Kelos Task Status

Task kelos-triage-910 has succeeded. ✅

[kelos-bot]

🤖 Kelos Agent @gjkim42

Kelos Triage Report

Kind: kind/docs
Priority: priority/backlog — Docs gap for a single flag; discoverable via kelos run --help in the meantime
Actor: actor/kelos — Straightforward doc addition to two files with clear scope and verifiable acceptance criteria

Status: STILL VALID

Evidence:

• --prompt-file flag is defined at internal/cli/run.go:322 with full implementation (file reading, stdin via -, mutual exclusivity with --prompt)
• docs/reference.md lists 14 flags for kelos run but omits --prompt-file
• README.md contains no mention of --prompt-file
• No merged PRs or commits reference issue Docs: 'kelos run --prompt-file' flag undocumented in CLI reference and README #910
• No commits on main mention prompt-file in docs context

Duplicates found: None found — other open doc issues (#827, #767, #773, #674, #648, #602) cover different commands/flags

Recommendation: KEEP OPEN — Add --prompt-file to the kelos run Flags section in docs/reference.md and optionally add a stdin usage example to README.md