feat(cli): add session commands #256

Closed
opened 2026-02-22 23:40:37 +00:00 by freemo · 0 comments
Owner

Metadata

  • Commit: feat(cli): add session commands
  • Branch: feature/m3-session-cli

Subtasks

  • Implement agents session create/list/show/delete/export/import/tell with --actor, --stream, and format outputs.
  • Ensure session tell uses SessionService append + actor execution, updates last_active, and persists message order.
  • Validate session export/import paths (create dirs, refuse overwrite unless --force) and guard against missing session IDs.
  • Add --format json/yaml support for list/show and include message counts + last_active timestamps.
  • Update CLI reference with session command examples, streaming notes, and JSON output shape.
  • Tests (Behave): Add features/session_cli.feature covering create/list/show/delete/export/import/tell flows + error cases.
  • Tests (Robot): Add robot/session_cli.robot end-to-end session flows with export/import round-trip.
  • Tests (ASV): Add benchmarks/session_cli_bench.py for command parsing overhead.
  • Verify coverage >=97% via nox -s coverage_report.
  • Run nox (all default sessions, including benchmark), fix any errors if needed ensuring nox passes.

Section: #### Section 3 Notes
Status: Completed

## Metadata - **Commit**: `feat(cli): add session commands` - **Branch**: `feature/m3-session-cli` ## Subtasks - [x] Implement `agents session create/list/show/delete/export/import/tell` with `--actor`, `--stream`, and format outputs. - [x] Ensure `session tell` uses SessionService append + actor execution, updates last_active, and persists message order. - [x] Validate `session export/import` paths (create dirs, refuse overwrite unless `--force`) and guard against missing session IDs. - [x] Add `--format json/yaml` support for list/show and include message counts + last_active timestamps. - [x] Update CLI reference with session command examples, streaming notes, and JSON output shape. - [x] Tests (Behave): Add `features/session_cli.feature` covering create/list/show/delete/export/import/tell flows + error cases. - [x] Tests (Robot): Add `robot/session_cli.robot` end-to-end session flows with export/import round-trip. - [x] Tests (ASV): Add `benchmarks/session_cli_bench.py` for command parsing overhead. - [x] Verify coverage >=97% via `nox -s coverage_report`. - [x] Run `nox` (all default sessions, including benchmark), fix any errors if needed ensuring nox passes. **Section**: #### Section 3 Notes **Status**: Completed
freemo added this to the v3.3.0 milestone 2026-02-22 23:40:37 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks Depends on
#132 develop-brent-2
cleveragents/cleveragents-core
Reference
cleveragents/cleveragents-core#256
No description provided.