Browse, organize, and branch agent sessions

Goal

Help users recover and safely continue past agent work.

Steps

1. Use list_sessions(directory=project_dir) to list sessions by last-modified time and show summary, branch, and file size with get_session_info. [sessions]
2. On selection, load history using get_session_messages; title with rename_session and categorize with tag_session, using a soft-hidden tag by default. [sessions]
3. For a new direction, call fork_session(session_id, up_to_message_id=...), then resume with ClaudeAgentOptions(resume=fork.session_id) and verify the source session is unchanged. [sessions]

How to verify

The sidebar and message order match the transcript; the fork has its own session ID, writes continue on the fork, and the original remains intact.

Troubleshooting

If the list is empty, check that `directory` matches the `cwd` used to create sessions; hard deletion removes the transcript, so prefer a hidden tag.