Skip to content

Feature request: show session names (Claude Code /rename customTitle, Codex thread_name) #178

Description

@hamaney

Summary

Claude Code lets users name a session with /rename <name>. abtop currently identifies sessions only by project directory, PID/session id, and the generated summary, so several sessions in the same repo are hard to tell apart. It would help to show the user-assigned name.

Where the name lives

/rename appends a line to the session transcript (~/.claude/projects/<project>/<session-id>.jsonl):

{"type":"custom-title","customTitle":"BATCH-PROGRESS-UPDATE","sessionId":"3dd909ae-e856-45e7-aaf0-a3a71e937eec"}

The entry can appear more than once (each rename appends a new one), so the last custom-title line wins.

Proposal

  • Parse the latest custom-title entry while reading the transcript.
  • When present, show it in the Session/Summary column (or in place of the generated summary), and expose it as a field such as custom_title in the --once/JSON output.
  • Fall back to the current behavior when no name is set.

Tested against abtop 0.5.5 on macOS (Homebrew).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions