| name | role-persona |
| description | Role-persona CLI for managing AI agent identity, memory, and knowledge systems. Use this skill when the user wants to: manage roles/identities, view or edit agent memory, search past learnings and preferences, export memory reports, manage knowledge bases, configure role mappings, build system prompts, or interact with the role-persona daemon. Triggers: role, memory, learnings, preferences, knowledge, identity, persona, prompt, consolidate, export, daemon, role-persona, agent memory, persistent memory.
|
role-persona Skill
CLI tool for managing AI agent identity, persistent memory, and knowledge bases.
Core Concepts
- Role: An agent identity with name, emoji, persona, and soul files. Roles live in
~/.pi/roles/.
- Memory: Persistent learnings (facts) and preferences (behavior rules) stored in Markdown files.
- Knowledge Base: Categorized documents searchable by tags and content.
- Daemon: Background HTTP server (~0.3s response) with auto-start on first CLI call.
CLI Reference
All commands output JSON by default ({ ok, data, error, message }). Add --human for formatted output.
Role Management
role-persona role list
role-persona role create
role-persona role info
role-persona role map <name>
role-persona role unmap
Memory Operations
role-persona memory add-learning
role-persona memory add-preference
role-persona memory search
role-persona memory list
role-persona memory consolidate
role-persona memory repair
role-persona memory tidy --model <m>
role-persona memory
role-persona memory conflicts
role-persona memory
role-persona memory build-prompt
role-persona memory extract-memory
role-persona memory flush
role-persona memory update-learning
role-persona memory update-preference
role-persona memory delete-learning
role-persona memory delete-preference
role-persona memory reinforce
