Sessions Chronicle

Browse, search, and resume your AI assistant sessions

Sessions Chronicle indexes all your local AI assistant sessions into a searchable database, so you can find any conversation, inspect tool calls, diagnose source indexing issues, and pick up where you left off.

→ Read the User Guide to get started.

Features

• Full-text search across all conversations (SQLite FTS5)
• Search your sessions straight from the GNOME Activities overview
• Sidebar filters by project and assistant with keyword search
• Filter the session list by date (Today, Yesterday, or a custom range)
• Markdown rendering (code blocks, tables, task lists, blockquotes)
• Expand inline tool calls and drill down into subagents; consecutive calls are grouped and collapsible
• Pin favorite sessions
• Per-session token breakdowns in detail view
• Assistant status dots, issue banner, empty-state diagnostics, and detailed indexing status dialog
• Launch sessions directly from the app in your terminal
• Supports 5 AI assistants — Claude Code, OpenCode, Codex, Mistral Vibe, and Kimi Code
• View most-used assistants, most-active days, and more

The GNOME search provider is off by default: enable Sessions Chronicle in Settings ▸ Search, then type at least three characters in the Activities overview. Results show the session's first prompt; matching transcript excerpts stay hidden unless you turn them on in Preferences ▸ System Search. See the User Guide for details.

Kimi Code support covers current sessions under $KIMI_CODE_HOME (default ~/.kimi-code) when that location is visible in the Flatpak sandbox. Legacy sessions under ~/.kimi are not parsed.

Installation

1. Install the self-hosted Flatpak remote:

flatpak install --user https://sessions-chronicle.maciz.dev/flatpak/dev.maciz.sessionschronicle.flatpakref

2. Launch Sessions Chronicle from your app menu, or run:

flatpak run dev.maciz.sessionschronicle

The Flatpak remote is the recommended install path: it is signed and updates automatically with flatpak update.

Build from source (native)

Contributors and advanced users can build a native Linux binary with Meson instead of Flatpak. This produces a regular GTK / Libadwaita application that links against your system libraries, so you need the development packages for them.

Build dependencies

• Rust toolchain (cargo) — Rust 2024 edition
• Meson >= 0.59 and Ninja
• GLib / GIO >= 2.84
• GTK 4 >= 4.18
• GtkSourceView 5 >= 5.0
• Libadwaita >= 1.8

These minimums are set by the Rust bindings (the gnome_48 GTK feature requires GTK 4.18 / GLib 2.84, and Libadwaita 1.8 APIs are used), and match the GNOME 49 runtime the Flatpak build targets — not the lower floors declared in meson.build.

On Fedora, the system packages are roughly:

sudo dnf install cargo meson ninja-build \
  glib2-devel gtk4-devel gtksourceview5-devel libadwaita-devel

On Debian/Ubuntu, the equivalents are cargo meson ninja-build libglib2.0-dev libgtk-4-dev libgtksourceview-5-dev libadwaita-1-dev.

Configure, compile, and install

meson setup builddir --prefix="$HOME/.local"
meson compile -C builddir
meson install -C builddir

Then run the installed build:

"$HOME/.local/bin/sessions-chronicle"

For the faster day-to-day development loop (development profile, incremental rebuilds) see docs/DEVELOPMENT_WORKFLOW.md.

Screenshot

See the website for more screenshots and project details: https://sessions-chronicle.maciz.dev/

Inspiration

Inspired by agent-sessions.

License

Licensed under MIT. See LICENSE.