How do I install the Export Timeline PDF skill?

Run npx skillmds@latest add rcarmo/export-timeline-pdf in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Export Timeline PDF safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Export Timeline PDF?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Export Timeline PDF free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Export Timeline PDF?

rcarmo (@rcarmo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Export Timeline PDF by rcarmo — Agent Skill

Name: Export Timeline PDF
Author: rcarmo

File contents

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 ../../scripts/export-timeline-pdf.ts --chat web:default --last 50

Export a date range:

bun ../../scripts/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 ../../scripts/export-timeline-pdf.ts --chat web:default \
  --from-row 1234 --to-row 1300

Dark theme:

bun ../../scripts/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, then renders that local file so bearer tokens are not passed to wkhtmltopdf.

---name: export-timeline-pdfdescription: Export a chat timeline to a PDF using the internal localhost export endpoint and wkhtmltopdf.---# Export timeline PDFExport chat history through piclaw's internal localhost HTML export endpoint and render it with `wkhtmltopdf`.## Steps1. Export the last 50 messages: ```bash bun ../../scripts/export-timeline-pdf.ts --chat web:default --last 50 ```2. Export a date range: ```bash bun ../../scripts/export-timeline-pdf.ts --chat web:default \ --from "2026-03-01T00:00:00Z" --to "2026-03-05T23:59:59Z" ```3. Export a specific message range by row ID: ```bash bun ../../scripts/export-timeline-pdf.ts --chat web:default \ --from-row 1234 --to-row 1300 ```4. Dark theme: ```bash bun ../../scripts/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 |## AuthThe internal endpoint is only available on localhost and requires an internal auth key.The script resolves it in this order:1. `--auth-key`2. `PICLAW_EXPORT_AUTH_KEY`3. `PICLAW_INTERNAL_SECRET`4. `PICLAW_WEB_INTERNAL_SECRET`5. `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, then renders that local file so bearer tokens are not passed to `wkhtmltopdf`.

Frequently asked questions

Export Timeline PDF