pi-chronicle

v0.1.0

Published

9 days ago

Record conscious markers and typed beats during work sessions, then write chronicle markdown to your vault Progress folder.

0High
0Medium
0Low

eiei114

pi-package pi chronicle session-log agent-skill typescript

Pi Chronicle

Record conscious markers and typed beats during work sessions, then write chronicle markdown to your vault.

What this is

A Pi extension that captures intentional session logs — not automated transcripts. Mark decisions, blockers, milestones, tries, and reverts as you work, then finalize a single chronicle markdown file into your vault's Progress/ folder.

For developers and creators who want a lightweight record of why they did things in that order — raw material for flow docs, blog posts, or retrospectives.

Features

Auto-start — session begins when Pi loads; no explicit start command
6 colon-flat commands — no arguments, no flags; prompted after invocation
5 beat types — decision, blocker, milestone, try, revert
Project detection — auto-resolves output folder from current working directory
Vault output — writes chronicle-YYYYMMDD-HHmm.md to your project's Progress/ folder
Novel generation — /chronicle:novel generates a short novel from session marks/beats via Pi agent
Distill select — choose a target format (flow, textbook, essay, fiction) for future generation

Install

pi install npm:pi-chronicle

Or try without permanent install:

pi -e npm:pi-chronicle

Quick start

/chronicle:mark    → enter a short label
/chronicle:beat    → pick type → enter label
/chronicle:end     → optional closing note → writes chronicle md
/chronicle:status  → show current session
/chronicle:distill → pick output format
/chronicle:novel   → generate novel from session → writes to project root

Session auto-starts when Pi loads. No /chronicle:start needed — just mark and beat as you work.

Package contents

| Path | Purpose | |---|---| | extensions/ | Pi TypeScript extension entrypoints | | lib/ | Shared session and output logic | | skills/ | Agent Skills | | docs/ | Optional supporting docs |

Development

npm install
npm run ci

Release

npm Trusted Publishing — no NPM_TOKEN required.

npm version patch
git push

See docs/release.md for setup details.

Security

Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.

For vulnerability reporting, see SECURITY.md.

License

MIT