Skip to content

v0.3.0 - Search overhaul + Session grouping

Choose a tag to compare

@github-actions github-actions released this 09 May 02:58
· 26 commits to main since this release

agent-session-tui v0.3.0

Search That Actually Finds Things

The biggest improvement in this release. Both search modes — plain text matching and semantic similarity — now look at the full content of every session, not just titles.

What got added to the index:

  • Session head — opening turns
  • Session tail — recent turns
  • Compaction summaries — what the agent has summarized after long conversations
  • Task-complete summaries — what the agent reported on finishing tasks
  • Your messages — full text of what you said, not just what the agent replied

In practice: if you mentioned a name, a function, a colleague, an error code, a Slack channel, a PR number — it shows up in / search now. Even when it was buried 200 turns into a conversation that was later compacted away.

Session Grouping

Organize sessions into thematic groups (e.g. tui-development, agent-customization, release-prep). A session can belong to multiple groups. View them via Shift+Tab → Grouped view.

In the Grouped view, groups are ordered by most-recent member activity (newest at the top). The order is held steady while you browse so the 2-second scan refresh doesn't shuffle them.

There are two ways to assign sessions — pick whichever fits how you work.

Manual grouping

No setup, no external tools. Highlight a session, press g:

  • A picker appears with your existing groups. Use ← → to scroll, Enter to assign.
  • To create a new group, just type the name and press Enter.
  • Press g again on the same session to assign it to additional groups.
  • Sessions appear under each group they belong to in the Grouped view.

AI auto-suggest (optional, opt-in)

For users with hundreds of sessions, GitHub Copilot CLI can propose groups for you. Suggestions appear inline as a dim · ⟨group⟩ shadow under the session row — press y to accept, n to dismiss, e to edit before saving.

The whole feature is off by default. The s shortcut and any background AI activity are completely hidden until you explicitly turn it on.

To enable:

  1. Install GitHub Copilot CLI: https://docs.github.com/en/copilot/github-copilot-cli
  2. Authenticate: copilot login
  3. Add an [acp] section to your config.toml (next to the binary):
    [acp]
    command = "copilot"
    extra_args = ["--effort", "low"]
    auto_suggest = false               # set true for background mode
    timeout_secs = 180
  4. The prompts/group-suggest.md template ships in the release zip — keep it next to the binary.

Two trigger modes once enabled:

  • s in Grouped view — runs one batch on demand; results show in a popup for review
  • Background — set auto_suggest = true; the TUI quietly runs after each session load and chains batches until every ungrouped session has been analyzed

Privacy: only session titles, summaries, and timestamps are sent to the AI. Full file contents and chat transcripts are never included.

Cost: each AI batch counts against your Copilot CLI usage quota.

New Keybindings

Key Action
g Assign current session to a group (manual)
s Run AI grouping batch (Grouped view, only if [acp] is configured)
y / n / e Accept / dismiss / edit a pending AI suggestion

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com