claude-sessions-cli

๐Ÿ“Œ Pinning & Tagging

Organise Chat sessions with pin stars and collapsible

The Chat tab holds sessions from ~/.claude-sessions/chats/. Unlike Code sessions, chats can be hand-organised with pins and tags so your most important conversations stay reachable.

โญ Pinning

Press p on a Chat session to pin it (or unpin it). Pinned sessions are marked with a star (โ˜…) and float to the top of the Chat tab, above all tag folders and untagged sessions.

Pins are persisted to ~/.claude-sessions/session-pins.json, so they survive across launches.

๐Ÿท๏ธ Tagging

Press t on a Chat session to set or clear a #tag. Sessions sharing a tag are grouped into a collapsible folder labelled with that tag. Press space on a tag header to expand or collapse the folder.

Tags are persisted to ~/.claude-sessions/session-tags.json.

๐Ÿ”ข Ordering

The Chat tab lists sessions in this order:

  1. Pinned sessions (โ˜…), in their own block at the top.
  2. Tagged sessions, grouped into collapsible #tag folders.
  3. Untagged sessions, listed at the bottom.

๐Ÿ“„ CLAUDE.md per chat

New chat sessions get a CLAUDE.md bootstrapped automatically. Press m on any Chat session to preview its CLAUDE.md inline without leaving the TUI, and press f to open the session folder in Finder.

On this page