session-pages-cli

session-pages-cli is a Node.js CLI that scans local AI session logs (currently Codex), exports session history to Markdown, and publishes updates to a Git repository for static-site display.

Install (Global)

npm install -g session-pages-cli

After install, use sp directly.

Quick Start

sp init --repo <git_remote_url>
sp sync
sp build-site
sp preview-site --port 4321

On Windows, ensure npm is available in PATH (typically via Node.js installer). Run sp commands in your project root (the directory containing ./site and ./.sp). sp init now bootstraps the site/ scaffold automatically if missing. On first sp build-site / sp preview-site, site dependencies are auto-installed if missing.

Commands

sp init --repo <git_remote_url> [--interval 30]
sp sync
sp watch --interval 30
sp status
sp doctor
sp build-site          # sync + build
sp preview-site --port 4321   # sync + build + preview

Development (Local)

npm install
npm run build
node dist/index.js --help

Or run TypeScript entry directly:

npx tsx src/index.ts --help

Notes

• Default behavior enables auto push.
• If parsing errors occur in a sync run, push is skipped for that run.
• Current provider support: Codex (~/.codex/sessions).