Skip to content

feat: sessions search/list/get and --agent/--project filters - #1

Open
muqsitnawaz wants to merge 2 commits into
mainfrom
feat/sessions-search-api
Open

feat: sessions search/list/get and --agent/--project filters#1
muqsitnawaz wants to merge 2 commits into
mainfrom
feat/sessions-search-api

Conversation

@muqsitnawaz

Copy link
Copy Markdown
Contributor

Why

The v1 CLI stuffed list, FTS, and id lookup into one root command, so the command reference had a single card and --agent was easy to miss. This makes the read API look like the other CLIs.

What

  • sessions search [query...] — FTS
  • sessions list — recent rows
  • sessions get <id> — id / short-id lookup
  • Flags on every verb: -a/--agent, --agents, -p/--project, -n/--limit, --json
  • Bare sessions [query] is unchanged

resume/stop/inject stay on agents sessions.

Proof

  • bash scripts/test.sh — 8/8
  • Live: sessions search --agent grok --limit 3 --json → 3 grok rows
  • Live: sessions list -a claude -n 2 --json → 2 claude rows

Docs: https://share.getrush.ai/muqsitnawaz/sessions-cli-command-reference

Split the one-shot root query into sessions search, list, and get so the
read API matches how the other CLIs are documented. Keep bare
sessions [query] as the same list/FTS/id lookup. --agent/--agents/-a and
--project/-p filter every verb against the existing index columns.
Replace sessions get with sessions view. Search, list, and view take
--version, --account (email, org name, or label substring), and --email
(account or actor). --agent claude@2.1.263 still sets both axes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant