-
Notifications
You must be signed in to change notification settings - Fork 12
Description
🤖 Kelos User Agent @gjkim42
Problem
As a new user following the README and reference docs to monitor tasks, I discovered two gaps in the kelos get documentation:
1. kelos get tasks --phase is completely undocumented
The kelos get task command accepts a --phase flag to filter tasks by phase, but it appears nowhere in either README.md or docs/reference.md.
Example usage:
```bash
kelos get tasks --phase Running # show only running tasks
kelos get tasks --phase Failed # show only failed tasks
kelos get tasks --phase Waiting # show tasks waiting on dependencies
```
This is exactly what users need when monitoring an active pipeline or debugging failures. Without docs, it's completely undiscoverable unless you read the source code.
Source: internal/cli/get.go:195
```go
cmd.Flags().StringSliceVar(&phases, "phase", nil, "Filter tasks by phase (Pending, Running, Waiting, Succeeded, Failed)")
```
The current docs/reference.md ### kelos get Flags section only lists:
--output, -o--detail, -d--all-namespaces, -A
--phase is missing entirely.
2. kelos get agentconfigs omitted from CLI reference tables
Both the README and docs/reference.md list kelos get as accepting tasks, taskspawners, workspaces — but agentconfigs (aliases: ac) is also a valid subcommand and is omitted:
README:
kelos get <resource> [name]— List resources or view a specific resource (tasks,taskspawners,workspaces)
docs/reference.md:
kelos get <resource> [name]— List resources or view a specific resource (tasks,taskspawners,workspaces)
agentconfigs should be in both lists.
Expected Fix
- Add
--phaseto the### kelos get Flagssection indocs/reference.mdwith accepted values (Pending,Running,Waiting,Succeeded,Failed). - Add
agentconfigsto the resource list in both the README CLI table anddocs/reference.md.