CLI reference
kusaw prompt
Helpers for assembling step prompts
kusaw prompt
Helpers for assembling step prompts
Usage
kusaw prompt [flags]Flags
| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--config | string | Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search) | ||
--factory | string | factory name from kusaw list | ||
--help | -h | bool | false | help for prompt |
Subcommands
kusaw prompt fence
Wrap stdin in the untrusted-data fence
kusaw prompt fence --source <name> [--preamble] [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--config | string | Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search) | ||
--factory | string | factory name from kusaw list | ||
--help | -h | bool | false | help for fence |
--preamble | bool | false | Print the preamble line before the fence | |
--source | string | Fence source name |
Example:
kusaw prompt fence --source diff --preamble < notes.txtkusaw prompt render
Render a prompt template with inert values
kusaw prompt render --template <file> [--arg k=v]... [--arg-file k=path]... [--untrusted k=source]... [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--arg | stringArray | Named argument as name=value (repeatable) | ||
--arg-file | stringArray | Named argument whose value is the file contents (repeatable) | ||
--config | string | Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search) | ||
--factory | string | factory name from kusaw list | ||
--help | -h | bool | false | help for render |
--template | string | Template file to render | ||
--untrusted | stringArray | Mark an argument untrusted with a fence source (repeatable) |
Example:
kusaw prompt render --template prompts/plan.md --arg spec=x --arg label=demoExit codes
| Code | Name | Description |
|---|---|---|
| 0 | ok | Success. |
| 1 | error | Runtime error. |
| 2 | usage | Usage or validation error. |
| 3 | rejected | Control request rejected; the error string is printed verbatim. |
| 4 | not picked up | Control request not picked up within the wait time while serve runs. |
Example
kusaw prompt fence --source diff --preamble < notes.txt