Render SessionBook session work documents (`Sessions/*_session_work.md`) to printable PDF using the repo-owned renderer and print model. Use when Claude needs to generate or re-render a rehearsal PDF, include alternate parts with a flag, or troubleshoot PDF output from the SessionBook session workflow.
Render a printable PDF from a checked-in SessionBook session work doc without leaving the local-first workflow. Use the repo command here instead of the older external chord-chart workflow.
Work from a target Sessions/*_session_work.md file.
If the file was edited recently or PDF rendering fails, validate it first
with npm run generate:session-content. Fix malformed = part: / = alt:
markers or fenced chart blocks before retrying.
Ensure the Python dependency is available:
python3 -m pip install -r requirements-pdf.txt
Render the default PDF:
npm run render:session-pdf -- Sessions/<name>_session_work.md
Add flags only when asked:
--include-alternates= alt:--include-notes to print session / set / tune notes--print-large for a single-column large-print layoutTreat out/session-pdfs/<session>.pdf as the default output when no explicit
path is supplied.
If the user wants layout changes, adjust repo code and re-run the repo command instead of inventing an ad hoc external workflow.
--include-alternates is passed, and no notes unless
--include-notes is passed.session-work-first-pass when the user wants a printable
rehearsal artifact or layout feedback.