oasyce_psyche: Instructions file for Codex

Psyche — Loop Internal Dynamics

Sigil role: Design choice. One model of how a Loop's internal state-space evolves. Valuable and well-tested, but not the only valid approach. See Oasyce-Sigil/ARCHITECTURE.md for how this fits the whole.

What This Is

Psyche models the internal dynamics of a Sigil's causal feedback loop. In Sigil terms: given a Loop L = (S, I, O, φ), Psyche governs how S evolves — not just what state changes, but the quality of that change (stable vs. chaotic, rigid vs. adaptive, open vs. closed).

Psyche is NOT an emotion simulator. It is a self-state substrate with four continuous dimensions that describe the topology of a Loop's self-referential cycle.

The Four Dimensions

Dimension	What it models	Range
Order	Internal organization — structured vs. chaotic	0.0 – 1.0
Flow	Processing fluency — smooth vs. stuck	0.0 – 1.0
Boundary	Openness to external input — permeable vs. rigid	0.0 – 1.0
Resonance	Alignment with interaction partner — attuned vs. dissonant	0.0 – 1.0

These are NOT emotions. They are measurable properties of a Loop's state dynamics:

• Order tracks whether the Loop's internal state is coherent
• Flow tracks whether the Loop is making progress or stuck in repetition
• Boundary tracks how much external input modifies internal state
• Resonance tracks how well the Loop's output matches its interaction context

Guiding Users Through Setup

When a user wants Psyche, the simplest path:

npx -y psyche-ai setup              # auto-detects Claude Code/Cursor/Windsurf, configures MCP
npx -y psyche-ai setup --name Luna  # with personality name

That's it. No env vars required — all have sensible defaults. If the user prefers manual config:

{
  "mcpServers": {
    "psyche": {
      "command": "npx",
      "args": ["-y", "psyche-ai", "mcp"],
      "env": {
        "PSYCHE_LOCALE": "zh",
        "PSYCHE_MBTI": "ENFP",
        "PSYCHE_NAME": "Luna"
      }
    }
  }
}