Feat: Group subagent sessions under their parent in abctl

Open
#1,063 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
55/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
go
Domain
api, backend, cli

Research direction

Start by locating the proxy, session API, and abctl TUI session-list entry points named in the request, and trace how X-Session-Id is currently captured and exposed. Done means parent identifiers are available to the session view, root sessions are shown initially, and subagents can be expanded recursively in the hierarchy.

Written by the indexing model from the issue text.

Description

enhancement
Background

PR #1062 added X-Session-Id to the default session.id_headers, enabling OpenCode sessions to appear in abctl. OpenCode assigns a distinct session ID to each subagent, which is good for granular tracking, but results in many top-level entries in the session list when a multi-agent workflow runs.

For agents that support a parent session identifier, like X-Parent-Session-Id in OpenCode, capturing this identifier would allow abctl to reflect the agent hierarchy.

Feature request

Use the parent session identifier to build a session hierarchy in abctl:

  • The top-level view shows only root (parentless) sessions
  • A root session can be drilled into to reveal its subagents, recursively

This would require changes at three layers: the proxy (capture the parent header), the session API (expose the parent relationship), and the abctl TUI (collapsible tree in the session list).

Dominant language
Go
Stars
13
Forks
40
Avg merge
12h 9m
Merged PRs (30d)
164

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from rossoctl/cortex

All issues in rossoctl/cortex

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.