Hermes Session Exporter: developer tool for Hermes Agent

Export Hermes Agent sessions to Markdown, HTML or normalized JSON, with a TUI browser and web panel

What Hermes Session Exporter does

Hermes Session Exporter turns Hermes Agent conversations into clean, shareable files. It reads sessions from the local Hermes database, state.db, which it expects at ~/AppData/Local/hermes/ on Windows or ~/.local/share/hermes/ on Linux and macOS, and it can also take .json files, .jsonl files or a whole directory as input.

Three formats are available: GitHub-flavored Markdown with role headers, a standalone HTML page with embedded CSS that colors user, assistant and tool messages, and normalized JSON with a stable structure. A Textual TUI lets you browse sessions, preview messages, select several with s and export them together with E. The web command serves the same TUI in an embedded xterm.js terminal at http://127.0.0.1:8765. Filters include --chat-only, --no-tools and --redact for sensitive content, and --split writes one file per session. Exports go to the Desktop by default. It runs on Windows, macOS and Linux with Python 3.10 or newer.

Key features

Exports to Markdown, standalone HTML and normalized JSON
Textual TUI to browse, preview, select and batch-export sessions
Web panel with an embedded xterm.js terminal on localhost
Filters: --chat-only, --no-tools and --redact
Reads the local Hermes state.db or .json and .jsonl files and directories
Inspect command and --split for one file per session

When to use it

Sharing a Hermes conversation as a clean HTML page or Markdown file
Archiving sessions in normalized JSON for analysis
Redacting sensitive content before posting a transcript

Who it is for: Hermes Agent users who want to save, share or analyze their past conversations.

How it fits with Hermes Agent

Built for Hermes Agent: it reads the Hermes sessions and messages tables and the session files Hermes produces.

How to install Hermes Session Exporter

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pipx install git+https://github.com/aRYmK13/hermes-session-exporter.git

Requirements: Python 3.10 or newer on Windows, macOS or Linux

FAQ

What is Hermes Session Exporter?

Hermes Session Exporter is a Python tool that exports Hermes Agent sessions to Markdown, HTML or normalized JSON. It has a command line, a terminal browser and a localhost web panel.

How do I install Hermes Session Exporter?

Run pipx install git+https://github.com/aRYmK13/hermes-session-exporter.git. The README also shows a pip --user install from the same URL and an editable install from a clone.

Is Hermes Session Exporter free and open source?

Yes. The repository is released under the MIT license.