@0xkobold/pi-persona
PI Agent Personality and Identity Management Extension
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: @0xkobold/pi-persona. It is used for: PI Agent Personality and Identity Management Extension Full Skill content: https://321skill.com/skills/0xkobold-pi-persona/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
This Skill addresses the issue of AI agents frequently switching identities and experiencing memory confusion across different projects. When developing with the pi framework, the global persona and project context often need to be distinguished, and manually managing multiple configuration files is error-prone.
Usage is straightforward: after installation, create files like SOUL.md, IDENTITY.md, and USER.md in the user directory ~/.0xkobold/ to define the core persona. To override these for a specific project, create files with the same names in the project directory .0xkobold/. Use the /persona-reload command to refresh, /persona-init to initialize global default files, and /persona-init-project to generate project-level files. The built-in persona tool supports operations like reading, updating, and initialization.
It is well-suited for teams or individuals who need to manage multiple AI coding agents, especially developers who frequently switch project contexts and wish to maintain independent personas and rules for each project. Project managers can standardize the capabilities of the team's AI assistants, and agent developers can quickly switch configurations.
It is recommended to adopt this tool uniformly within a team: first define the global core persona, then create specific overrides for each project. Note that project-level files must be placed in the .0xkobold/ directory and ensure the scope: project tag is correctly set. This extension is only compatible with the pi framework and requires a Node.js environment.
Key Features
Compared to OpenClaw's Persona system, pi-persona supports the `scope: project` tag for project-level overrides and is deeply integrated with the pi ecosystem, enabling automatic loading in pi agents without additional adaptation.
Limitations
Only compatible with the pi framework; requires Node.js and npm environment, and depends on the pi command-line tool.
FAQ
How do I install pi-persona?
It is recommended to install via the bundled package using `pi install npm:@0xkobold/pi-kobold`. Alternatively, you can install it separately by running `pi install npm:@0xkobold/pi-persona`.
Where should project-level persona files be placed?
Place them in the `.0xkobold/` folder at the project root, using the same filenames as the global ones (e.g., SOUL.md), and prepend the metadata `---\nscope: project\n---`.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/0xkobold-pi-persona/raw/index.md to read the original Skill definition (Markdown format) for @0xkobold/pi-persona, and install it according to the instructions.
Raw Markdown URL for AI: /skills/0xkobold-pi-persona/raw/index.md