SessionShelf

中文 | English

SessionShelf is a macOS app for browsing and managing local Codex conversation sessions.

Status

• Browse local Codex .jsonl sessions by workspace, title, favorite, archive state, and search.
• Move selected sessions to macOS Trash; SessionShelf does not permanently delete conversation files.
• Store local metadata, notes, favorites, and full-text search cache in SQLite under Application Support.

Development

Open SessionShelf.xcodeproj in Xcode and run the SessionShelf scheme.

The app has been verified on macOS 26+. It does not intentionally use macOS 26-only APIs and is expected to support macOS 14.0+.

For local development, choose your own signing team in Xcode if prompted.

Acknowledgements

Thanks to cxresume by lingtaolf for the local Codex JSONL browsing inspiration.

Thanks to remodex for the thread metadata, title, and archive-state handling references that informed SessionShelf's local metadata design.