Architecture

Persona lives on the device that created it, including its Knowledge Base. Applying writes that bundle into the AI app on the same device. Sharing publishes a numbered revision for the organization.

For a non-technical overview, start with How It Works.

Where Persona is stored

~/.transcodes/personas/<name>/ on this computer. The bundle is an Instruction, Rules, Skills, and a Knowledge Base.

The Knowledge Base holds durable facts the agent must not guess — product names, URLs, token names, brand decisions, approved claims, and API contracts. It is not a policy and not a workflow. See Knowledge Base.

Apply and share

Apply writes the host files for Claude Code, Cursor, Codex, and Antigravity on this device. Local create, edit, and apply do not need a login.

Versioning publishes the same bundle as a numbered revision. A teammate downloads that revision, then applies it on their own device. Sharing is not apply.

Security issues: security@transcodes.io

Next steps