idiolect

id-i-o-lect (noun): the way one specific person uses language. Yours is unlike anyone else's.

AI assistants restart from zero on how you communicate, every session, in every tool. idiolect distills how you actually talk, from your own chat history, into a compact profile file you can read, edit, and carry anywhere.

• Local-first. Your transcripts never leave your machine. No cloud, no telemetry, no accounts.
• A file, not a service. No database, no daemon. The profile is Markdown you own.
• Transparent. Every observation the distiller makes is stored as text you can read and delete.

Status

v0. Currently distills from Claude Code session transcripts (~/.claude/projects/). More sources planned.

Usage

idiolect extract        # parse your transcripts into a local exemplar store
idiolect distill        # distill a profile from the exemplars (uses your claude CLI)
idiolect show           # print your profile
idiolect stats          # corpus statistics
idiolect install-hook   # auto-inject your profile into Claude Code sessions
idiolect uninstall-hook # remove the hook

All data lives in ~/.idiolect/. Delete that folder and everything is gone.

How the hook works

install-hook registers a Claude Code UserPromptSubmit hook (backing up your settings first). On the first real prompt of each session it attaches your profile as additional context, alongside your message, never replacing it. Once per session only: after that, the profile is already in context.

The hook reads one local file and touches no network. It fails open: if anything goes wrong it stays silent and your prompt goes through untouched. Applies to sessions started after installation.

License

MIT