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