pi-claudian

A monorepo of independently-published pi extensions for collaborating with Claudian.

Each extension lives in its own package under packages/* and is published to npm as TypeScript source (pi loads it via jiti, no build step), so you can install only what you need:

pi install npm:<package-name>

Extensions

Package	Description
@pi-claudian/sync-title	Sync Claudian conversation titles into pi session names so they appear in /resume.
@pi-claudian/sync-session	Sync pi /tree and /fork session changes into Claudian's conversation metadata.

Development

Requires Node.js 20+ and pnpm.

pnpm install      # install dependencies
pnpm typecheck    # type-check all packages (tsc --noEmit)
pnpm lint         # check formatting with prettier
pnpm format       # fix formatting with prettier

Debugging

All @pi-claudian extensions support a shared debug switch. Set one environment variable to trace every extension on stderr (never mixed with pi's stdout):

PI_CLAUDIAN_DEBUG=1 pi              # show debug output inline
PI_CLAUDIAN_DEBUG=1 pi 2>debug.log  # capture to a file

Releasing

This repo uses Changesets for independent versioning and publishing of each extension.

pnpm changeset    # describe a change (creates a changeset file)
pnpm version      # apply changesets -> bump versions, update CHANGELOGs
pnpm release      # publish all changed packages to npm

See .changeset/README.md for details.

Contributing

Contributions are welcome — bug reports, feature ideas, new extensions, or fixes. See CONTRIBUTING.md to get started.

Quick links:

• Open an issue
• Start a discussion
• Look for good first issue / help wanted labels

New to the codebase? packages/sync-title is a minimal, up-to-date template to copy when adding an extension.

License

MIT