Chat Export plugin thumbnail

Chat Export

Export full chat conversations in multiple formats (MD, TXT, PDF, DOCX, HTML, EPUB, LaTeX, RST, ODT, RTF) via pandoc.

Author guyjames 0 stars Version 1.0.0 Updated
ToolsDocumentsExport
GitHub Repository Discussion How to install

README

Chat Export Plugin

Export full Agent Zero chat conversations in multiple formats.

Supported Formats

Format Extension Description
Markdown .md Clean markdown with metadata header
Plain Text .txt Stripped of markdown formatting
PDF .pdf Via pandoc + XeLaTeX
Word .docx Microsoft Word format
HTML .html Standalone HTML
EPUB .epub E-book format
LaTeX .tex LaTeX source
reStructuredText .rst Sphinx/RST format
OpenDocument .odt LibreOffice Writer
Rich Text .rtf Rich Text Format

Features

Full / Clean Mode

The export dropdown includes a Full / Clean toggle:

  • Full — exports everything: user messages, assistant responses, agent thinking, code execution, system messages
  • Clean — exports only User and Assistant messages, stripping out all internal processing details

Smart Content Formatting

  • User and assistant messages rendered naturally
  • Agent entries show headline, thoughts summary, and tool calls
  • Code execution entries wrapped in code blocks with cleaned headings
  • System/utility progress messages filtered out
  • Metadata header with chat name, creation date, and export date

Graceful Fallback

  • Markdown (.md) and Plain Text (.txt) work without pandoc
  • If pandoc is missing, other formats automatically fall back to .md

Usage

  1. Open a chat in the Agent Zero web UI
  2. Click the Export button in the bottom action bar (next to Pause Agent / Nudge)
  3. Choose Full or Clean mode
  4. Select your desired format
  5. The file downloads automatically

Requirements

  • pandoc must be installed for PDF, DOCX, EPUB, LaTeX, RST, ODT, RTF export
  • texlive-xetex is needed for PDF output
  • Markdown (.md) and Plain Text (.txt) work without pandoc

Installation

The plugin installs automatically when placed in /a0/usr/plugins/chat_export/. If pandoc is not installed:

apt-get install -y pandoc texlive-xetex texlive-fonts-recommended

Architecture

chat_export/
├── plugin.yaml              # Plugin metadata
├── README.md                # This file
├── webui/
│   └── thumbnail.png        # Plugin icon
├── api/
│   └── export_chat.py       # Backend API handler
└── extensions/
    └── webui/
        └── chat-input-bottom-actions-start/
            └── export-button.html  # Frontend button + dropdown
  • api/export_chat.py — Backend API handler that reads chat.json, converts to Markdown, then uses pandoc for format conversion
  • extensions/webui/chat-input-bottom-actions-start/export-button.html — Frontend button with format dropdown, placed in the chat bottom action bar
  • plugin.yaml — Plugin metadata

API Endpoint

POST /plugins/chat_export/export_chat

Parameters:

  • context (string, required) — Chat ID
  • format (string, required) — One of: md, txt, pdf, docx, html, epub, tex, rst, odt, rtf
  • clean (boolean, optional) — If true, export only user and assistant messages (default: false)

Response: File download with appropriate Content-Type and Content-Disposition headers.

Export File Naming

Exported files are named: <chat-name>-<date>.<ext>

  • Chat name is sanitized for filesystem compatibility
  • Date is in YYYYMMDD format (UTC)