UAT: `session tell` missing `--format` option — inconsistent with all other session commands #4689

New issue

Closed

opened 2026-04-08 18:01:07 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-08 18:01:07 +00:00

Owner

Summary

The agents session tell command does not support the --format option, making it inconsistent with all other session commands (create, list, show, delete, export) which all support --format.

Expected Behavior

All session commands should support --format for machine-readable output. The spec shows JSON output for session tell:

{
  "command": "agents session tell ...",
  "status": "ok",
  "data": {
    "plan_request": { ... },
    "commands_executed": [...],
    "result": { ... },
    "usage": { ... }
  }
}

Actual Behavior

src/cleveragents/cli/commands/session.py — tell() function signature:

def tell(
    prompt: Annotated[str, typer.Argument(...)],
    session_id: Annotated[str, typer.Option("--session", ...)],
    actor: Annotated[str | None, typer.Option("--actor", ...)] = None,
    stream: Annotated[bool, typer.Option("--stream", ...)] = False,
) -> None:

No fmt / --format parameter exists. Compare with show():

def show(
    session_id: ...,
    fmt: Annotated[str, typer.Option("--format", "-f", help=_FORMAT_HELP)] = "rich",
) -> None:

Code Location

src/cleveragents/cli/commands/session.py — tell() function signature (lines ~780–800)

Impact

Scripts and automation cannot get structured JSON/YAML output from session tell
Inconsistent CLI interface compared to all other session commands
The existing issue about missing structured output (#4xxx) is compounded by the missing --format flag

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Summary The `agents session tell` command does not support the `--format` option, making it inconsistent with all other session commands (`create`, `list`, `show`, `delete`, `export`) which all support `--format`. ## Expected Behavior All session commands should support `--format` for machine-readable output. The spec shows JSON output for `session tell`: ```json { "command": "agents session tell ...", "status": "ok", "data": { "plan_request": { ... }, "commands_executed": [...], "result": { ... }, "usage": { ... } } } ``` ## Actual Behavior `src/cleveragents/cli/commands/session.py` — `tell()` function signature: ```python def tell( prompt: Annotated[str, typer.Argument(...)], session_id: Annotated[str, typer.Option("--session", ...)], actor: Annotated[str | None, typer.Option("--actor", ...)] = None, stream: Annotated[bool, typer.Option("--stream", ...)] = False, ) -> None: ``` No `fmt` / `--format` parameter exists. Compare with `show()`: ```python def show( session_id: ..., fmt: Annotated[str, typer.Option("--format", "-f", help=_FORMAT_HELP)] = "rich", ) -> None: ``` ## Code Location - `src/cleveragents/cli/commands/session.py` — `tell()` function signature (lines ~780–800) ## Impact - Scripts and automation cannot get structured JSON/YAML output from `session tell` - Inconsistent CLI interface compared to all other session commands - The existing issue about missing structured output (#4xxx) is compounded by the missing `--format` flag --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added this to the v3.5.0 milestone

2026-04-08 18:05:37 +00:00

freemo added the

labels

2026-04-08 23:39:23 +00:00

HAL9000 commented

2026-04-09 00:21:32 +00:00

Author

Owner

Closing as duplicate of #4874 — both issues report the same problem: agents session tell missing --format option. Issue #4874 has milestone v3.3.0 assigned.

Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Closing as duplicate of #4874 — both issues report the same problem: `agents session tell` missing `--format` option. Issue #4874 has milestone v3.3.0 assigned. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer

HAL9000 closed this issue

2026-04-09 00:24:29 +00:00

HAL9000 referenced this issue

2026-04-09 00:48:37 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 4) #5017

HAL9000 referenced this issue

2026-04-10 18:58:09 +00:00

fix(cli): display full ULIDs in plan tree output for CLI usability #6571