// Export a chat timeline to a PDF using the internal localhost export endpoint and wkhtmltopdf.
| name | export-timeline-pdf |
| description | Export a chat timeline to a PDF using the internal localhost export endpoint and wkhtmltopdf. |
| distribution | public |
Export chat history through piclaw's internal localhost HTML export endpoint and render it with wkhtmltopdf.
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
| 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 |
The internal endpoint is only available on localhost and requires an internal auth key. The script resolves it in this order:
--auth-keyPICLAW_EXPORT_AUTH_KEYPICLAW_INTERNAL_SECRETPICLAW_WEB_INTERNAL_SECRETweb.internalSecret from /workspace/.piclaw/config.jsonwkhtmltopdf must be installed and available on PATHGET /internal/export/timeline.Use the stealth browser for human-like web automation against bot-protected sites. Handles login flows, scraping, and form filling with anti-detection bypass.
Nightly Bayesian interaction-quality classifier — flags behavioral patterns from chat history and writes self-improvement reflections without spending model tokens on classification.
Record major friction or postmortem feedback in the configured workspace vent log.
Open a spreadsheet-style widget for a Markdown table so the user can edit it and send the final Markdown table back into chat.
git_history and json_query tools for structured git log exploration and jq-style JSON querying.
Use `code_search` and `code_rewrite` for syntax-aware code search and refactors when structure matters.