Superself plugin

A Claude Code plugin that connects your agent to Superself: shared project context carried across sessions, a token-savings discipline nudged at session start, and lightweight usage collection so you can see what your sessions cost. Install by pointing your agent at our install guide — https://superselfs.com/install — and it will walk itself through the marketplace add, plugin install, and OAuth connection steps.

What the hooks send

This plugin ships two hooks:

• superself-transcript-upload.sh (Stop/SessionEnd) — uploads the raw local session transcript (jsonl), but only for sessions you explicitly opened with the Superself MCP tool session_open (a marker file records the upload target for that session). If you never open a Superself session, this hook is a no-op.
• superself-usage-collect.mjs (SessionEnd) — reports token count deltas only (input/output/ cache read/cache creation, aggregated per model) for every session, once you've registered a collector token via the collector_register MCP tool. It never sends conversation content — just numbers.

Both hooks fail silently (non-blocking) and never interrupt your session.

Updating

The session-start prompt is fetched from the Superself server on each session (with the bundled copy as offline fallback), so prompt changes reach you without a plugin update. Plugin updates are only needed when the hook scripts themselves change — which is rare.

Claude Code doesn't auto-update third-party marketplaces by default. To pull the latest version:

/plugin marketplace update superself

See the install guide for enabling automatic updates.