Skip to content

v0.1.0 — first public release

Choose a tag to compare

@shojikumaru shojikumaru released this 18 Jul 06:10
· 107 commits to main since this release

The first public release of persona-engine: a safe, policy-driven engine for giving LLM agents a different face for each situation — while never rewriting the original personality.

Install

npm install -g @persona-engine/core

Highlights

  • Declarative packs — modes (faces) and vocabulary catalogs as plain YAML/text files, compiled once into deterministic, byte-stable blocks
  • Route policy — per-surface allow-lists and switching levels; unknown contexts fail closed to an empty public mode
  • Three switching paths — explicit utterance aliases, agent-initiated persona_set (owner-verified routes only), and admin CLI — all through one policy gate
  • Audit built in — every transition and denial is an append-only event, inspectable with persona audit
  • Adapters — Claude Code, Hermes, and OpenClaw; the adapter contract in SPEC.md is small
  • Starter pack — a complete four-mode example (focus / casual / professional / roleplay-template) with catalog samples

See the README for a quick start, a full walkthrough, and the customizing guide.