Polysona is a metacognition-driven multi-persona orchestration framework. It interviews you using 10 established psychology frameworks, structures the results into portable persona files, then runs a 5-agent content pipeline that keeps every output faithful to who you actually are — not a generic AI voice.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/LilMGenius/polysona/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Install Polysona and run your first interview in minutes.
Architecture
Understand the orchestrator, agents, and data flow.
Agents
Meet the 5 agents that power the content pipeline.
Skills & Commands
Reference every skill command for Codex and Claude Code.
Core Concepts
Learn about the PLOON format, 10 frameworks, and ego layers.
API Reference
Explore the local REST API served by the Hono dashboard server.
How it works
Interview
Run
$interview (Codex) or /interview (Claude Code) to start a deep psychology session. The Profiler agent conducts a structured interview using 10 frameworks — McAdams Life Story, Laddering, Clean Language, Johari Window, IFS, Repertory Grid, Object Relations, Projective Technique, Zen Koan, and 五倫+陰陽.Persona is structured
Polysona structures your interview log into three PLOON-format files:
persona.md (core identity, decisions, energy, blind spots), nuance.md (voice and platform patterns), and accounts.md (role models and virtual audience).Generate content
Run
$trend to find relevant topics, then $content [platform] to generate platform-native drafts — X, Threads, LinkedIn, Naver Blog, or Brunch — conditioned on your persona.Key capabilities
10 Psychology Frameworks
Western depth (6), Western supplement (2), and Eastern reflection (2) frameworks cover conscious goals, unconscious patterns, and the gaps between them.
Multi-Persona Support
Build and maintain distinct personas for different domains — executive, creator, gamer — each stored under
personas/{id}/.Platform-Native Drafts
Content-writer agent adapts tone, hook patterns, and emoji density per platform based on your
nuance.md voice profile.Virtual Follower QA
20 audience archetypes score every draft on hook, empathy, shareability, CTA, and platform fit before you publish.
Portable Personas
Export your persona to
CLAUDE.md or AGENTS.md with $export — drop it into any project to bring yourself along.Local-First Dashboard
Run
bun run dev to launch the Hono + React dashboard and inspect personas, pipeline status, and QA simulations.