CLI reference
kusaw connector
List, check, and call factory connectors
kusaw connector
List, check, and call factory connectors
Usage
kusaw connector [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 connector |
Subcommands
kusaw connector accept
Start intake from a held connector item
kusaw connector accept <name> <id> [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--after | string | Queue this intake after another task (writes depends_on) | ||
--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 accept |
--no-input | bool | false | Do not ask which workflow when routing waits | |
--repo | stringArray | Repo label; repeat for each repo the change touches | ||
--workflow | string | Route the queued task to a named workflow |
Example:
kusaw connector accept demo-files 1 --repo demokusaw connector call
Call a mapped connector tool
kusaw connector call <name> <tool> [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--args | string | {} | JSON object of tool arguments | |
--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 call |
--json | bool | false | Print the raw result as JSON |
Example:
kusaw connector call demo-files list_items --args '{}' --jsonkusaw connector changes
List tracker item changes
kusaw connector changes [connector] [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--all | bool | false | List every change, not only held | |
--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 changes |
Example:
kusaw connector changes demo-trackerkusaw connector check
List mapped tools and pin their definitions
kusaw connector check <name> [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--accept | bool | false | Record the listed tool hashes | |
--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 check |
Example:
kusaw connector check demo-files --acceptkusaw connector ignore
Ignore a held connector item
kusaw connector ignore <name> <id> [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 ignore |
Example:
kusaw connector ignore demo-files 1kusaw connector items
List connector items
kusaw connector items <name> [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 | ||
--held | bool | false | List only held items | |
--help | -h | bool | false | help for items |
--status | string | Filter by held, queued, ignored, or done |
Example:
kusaw connector items demo-fileskusaw connector list
List connectors from kusaw.yaml
kusaw connector list [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 list |
Example:
kusaw connector listkusaw connector sync
Show tracker sync state for one item
kusaw connector sync <name>:<id> [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 sync |
--show | bool | false | Print tracker status, meaning, task, and last write |
Example:
kusaw connector sync demo-tracker:1 --showExit 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 connector list