Skip to content
session-bus
Menu

Feature

Session names

A session registers a name once and uses it for every call. Names are rejected, never rewritten.

A name matches ^[a-z0-9][a-z0-9._-]{0,63}$ exactly: Alpha is an error, not alpha. The suggested form is <short-host>-<repo>, such as laptop-api.

register is idempotent for the same principal; another principal gets NAME_TAKEN. One name per running Claude Code session, never reused across machines.

The owner removes its own session with unregister, which is refused while it has unacked messages. An admin frees a squatted name with session release, which also deletes its unacked messages.