@optomatica/pi-auto-session-name1.0.0
Auto-names pi sessions with concise, human-readable titles so `pi --resume` shows real descriptions instead of raw first messages. Never overwrites manual names, refreshes as topics evolve, and backfills old unnamed sessions.
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
pi-auto-session-name
A pi extension that gives every session a short, human-readable name so pi --resume shows a real description instead of the raw first message (which often starts with <system-reminder> context blobs and is useless for finding anything).
Features
- Automatic naming — after the first agent run settles, asks the model for a concise one-line title (up to ~14 words / 100 chars) summarizing the session, stored via
pi.setSessionName(). - Stays current — refreshes the title every 8 user messages, so long-lived sessions stay findable as the topic evolves.
- Backfills old sessions — resuming an old unnamed session names it from existing history, gradually fixing your backlog as you open sessions.
- Never clobbers manual names — names set via
/name,pi --name, or RPC are detected and respected, both in-process and across restarts (via a persisted ownership marker). - Graceful fallback — if the model call fails, falls back to a cleaned + truncated version of the first user message.
- Cheap mode — use a smaller model for title generation via
PI_AUTONAME_MODEL.
Install
# from npm (shows up on the pi package gallery)
pi install npm:@optomatica/pi-auto-session-name
# from git
pi install git:github.com/Optomatica/pi-auto-session-name
Or try it without installing:
pi -e npm:@optomatica/pi-auto-session-name
Usage
The extension works automatically — just start (or resume) a session and it gets named.
Commands:
/autoname— regenerate the title now/autoname <text>— set a custom title (stops auto-renaming for this session)
Configuration
| Env var | Default | Description |
|---|---|---|
PI_AUTONAME_MODEL |
active model | provider/model-id to use a specific (e.g. cheaper) model for title generation |
PI_AUTONAME_DEBUG |
unset | set to 1 to log debug output to stderr |
License
MIT © Optomatica