Agent Skills › rcarmo/piclaw › export-timeline-pdf

export-timeline-pdf

GitHub

通过本地导出端点和wkhtmltopdf将聊天记录导出为PDF，支持按时间、行数或数量筛选及主题切换。

skel/.pi/skills/export-timeline-pdf/SKILL.md rcarmo/piclaw

Trigger Scenarios

需要导出聊天记录为PDF文件生成聊天历史报告

Install

npx skills add rcarmo/piclaw --skill export-timeline-pdf -g -y

More Options

Non-standard path

npx skills add https://github.com/rcarmo/piclaw/tree/main/skel/.pi/skills/export-timeline-pdf -g -y

Use without installing

npx skills use rcarmo/piclaw@export-timeline-pdf

指定 Agent (Claude Code)

npx skills add rcarmo/piclaw --skill export-timeline-pdf -a claude-code -g -y

安装 repo 全部 skill

npx skills add rcarmo/piclaw --all -g -y

预览 repo 内 skill

npx skills add rcarmo/piclaw --list

SKILL.md

Frontmatter

{
    "name": "export-timeline-pdf",
    "description": "Export a chat timeline to a PDF using the internal localhost export endpoint and wkhtmltopdf.",
    "distribution": "private"
}

Export timeline PDF

Export chat history through piclaw's internal localhost HTML export endpoint and render it with wkhtmltopdf.

Steps

Export the last 50 messages:

bun /workspace/.pi/skills/export-timeline-pdf/export-timeline-pdf.ts --chat web:default --last 50

Export a date range:

bun /workspace/.pi/skills/export-timeline-pdf/export-timeline-pdf.ts --chat web:default \
  --from "2026-03-01T00:00:00Z" --to "2026-03-05T23:59:59Z"

Export a specific message range by row ID:

bun /workspace/.pi/skills/export-timeline-pdf/export-timeline-pdf.ts --chat web:default \
  --from-row 1234 --to-row 1300

Dark theme:

bun /workspace/.pi/skills/export-timeline-pdf/export-timeline-pdf.ts --chat web:default --last 20 --theme dark

Options

Flag	Description	Default
`--chat`	Chat JID to export	`web:default`
`--from`	Start timestamp (ISO 8601)	(all)
`--to`	End timestamp (ISO 8601)	(all)
`--from-row`	Start message row ID	(all)
`--to-row`	End message row ID	(all)
`--last`	Export only the last N messages	(all)
`--theme`	`light` or `dark`	`light`
`--out`	Output PDF path	`/workspace/exports/timeline-<chat>.pdf`
`--port`	Piclaw web port	auto-detect / `8080`
`--auth-key`	Internal export auth key	env/config lookup
`--html-only`	Save HTML sidecar without rendering PDF	off

Auth

The internal endpoint is only available on localhost and requires an internal auth key. The script resolves it in this order:

--auth-key
PICLAW_EXPORT_AUTH_KEY
PICLAW_INTERNAL_SECRET
PICLAW_WEB_INTERNAL_SECRET
web.internalSecret from /workspace/.piclaw/config.json

Prerequisites

wkhtmltopdf must be installed and available on PATH
piclaw web server must be running locally

Notes

The script is read-only: it never opens SQLite and never writes auth/session state.
The HTML export endpoint is GET /internal/export/timeline.
The script writes an HTML sidecar next to the PDF for inspection.