Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/josephyaduvanshi/claude-history-manager/llms.txt

Use this file to discover all available pages before exploring further.

Chronicle lives in your Mac’s menu bar so you can reach your sessions without switching away from whatever you are working in. A single global hotkey drops down a 480px popover showing your live, recent, and pinned sessions for the active provider. From there you can resume a session, switch providers, or dismiss the popover — all without touching the main window.

Opening and closing the dropdown

Press ⌘⇧O from anywhere on the system to open the menubar dropdown. The same shortcut closes it. Press to dismiss it without making a selection.

What the dropdown shows

The 480px popover is organized into three sections for the active provider:

Live sessions

Sessions currently being written to by one of the three CLIs, marked with a green pulse. Polled every two seconds.

Recent sessions

The most recently modified sessions for the active provider, ordered newest first.

Pinned sessions

Sessions you have pinned for the active provider. Pins are per-provider.

Keyboard navigation

Press ⌘1 through ⌘9 to resume the corresponding row in the dropdown using your default terminal. Rows are numbered top to bottom.
Press ⌘⇧↵ to resume the most-recently-modified session in your default terminal immediately. The dropdown does not need to be open — this shortcut works system-wide.
Press to close the dropdown without taking any action.

Switching providers in the dropdown

The dropdown is scoped to the active provider. Provider tiles at the top of the popover let you switch between Claude, Codex, and Gemini without opening the main window. Tapping a tile immediately updates the live, recent, and pinned session lists for that provider.
Provider tiles only appear for providers that have at least one indexed session on disk. If a CLI has never been run on your Mac, its tile is not rendered.

Relationship to the main window

The menubar dropdown and the main Chronicle window share the same active provider. Switching providers in the dropdown updates the main window when you open it, and vice versa.
⌘⇧↵ is the fastest way to jump back into your most recent session: it works system-wide, requires no visible UI, and completes in a single keystroke whether the dropdown is open or closed.

Build docs developers (and LLMs) love