---
slug: "pi-claudian-sync-title"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/licongy/pi-claudian@master/README.md"
repo: "https://github.com/licongy/pi-claudian"
source_file: "README.md"
branch: "master"
---
# pi-claudian

[![npm version](https://img.shields.io/npm/v/@pi-claudian/sync-title?style=flat&colorA=222222&colorB=CB3837)](https://www.npmjs.com/package/@pi-claudian/sync-title)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat&logo=typescript&logoColor=white)](https://www.typescriptlang.org)

A monorepo of independently-published [pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) 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`](https://github.com/licongy/pi-claudian/tree/HEAD/packages/sync-title)     | Sync Claudian conversation titles into pi session names so they appear in `/resume`. |
| [`@pi-claudian/sync-session`](https://github.com/licongy/pi-claudian/tree/HEAD/packages/sync-session) | Sync pi `/tree` and `/fork` session changes into Claudian's conversation metadata.   |

## Development

Requires Node.js 20+ and [pnpm](https://pnpm.io).

```sh
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):

```sh
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](https://github.com/changesets/changesets) for independent versioning and publishing of each extension.

```sh
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`](https://github.com/licongy/pi-claudian/blob/HEAD/.changeset/README.md) for details.

## Contributing

Contributions are welcome — bug reports, feature ideas, new extensions, or fixes.
See [CONTRIBUTING.md](https://github.com/licongy/pi-claudian/blob/HEAD/CONTRIBUTING.md) to get started.

Quick links:

- [Open an issue](https://github.com/licongy/pi-claudian/issues)
- [Start a discussion](https://github.com/licongy/pi-claudian/discussions)
- Look for [`good first issue`](https://github.com/licongy/pi-claudian/labels/good%20first%20issue) / [`help wanted`](https://github.com/licongy/pi-claudian/labels/help%20wanted) labels

New to the codebase? [`packages/sync-title`](https://github.com/licongy/pi-claudian/tree/HEAD/packages/sync-title) is a minimal,
up-to-date template to copy when adding an extension.

## License

[MIT](https://github.com/licongy/pi-claudian/tree/HEAD/LICENSE)