feat(tui): Persona system and reference/command input modes #695

New issue

Closed

opened 2026-03-11 18:12:41 +00:00 by freemo · 0 comments

freemo commented

2026-03-11 18:12:41 +00:00

Owner

Background and Context

Per ADR-045 (Persona System) and ADR-046 (Reference/Command System), the TUI provides:

Persona system — YAML-based abstraction bundling actor + args + scope + presets
Three input modes — Normal (@), Command (/), Shell (!)

Persona System

Personas are TUI-only YAML files that bundle an actor reference with pre-configured arguments, scope rules, and UI presets
Users select personas from a picker or via /persona command
Each session tab can have a different active persona
Personas define: display name, icon, actor reference, default arguments, scope rules, greeting message

Reference/Command System

Normal mode: @ triggers reference picker (files, actors, tools, skills)
Command mode: / triggers slash command system (plan, actor, session, etc.)
Shell mode: ! enters shell command passthrough
Autocompletion, fuzzy search, and category filtering

Acceptance Criteria

Persona YAML schema defined and parsed
Persona picker UI in TUI
/persona command to switch personas
Per-session persona binding
@ reference picker with autocompletion
/ slash command system with autocompletion
! shell mode passthrough
Category filtering in reference picker
Fuzzy search in all pickers

Metadata

Commit message: feat(tui): implement persona system and reference/command input modes
Branch name: feature/m8-tui-personas

Definition of Done

Persona system loads and applies YAML configs
All 3 input modes functional
Autocompletion works in all modes

## Background and Context Per ADR-045 (Persona System) and ADR-046 (Reference/Command System), the TUI provides: 1. **Persona system** — YAML-based abstraction bundling actor + args + scope + presets 2. **Three input modes** — Normal (@), Command (/), Shell (!) ### Persona System - Personas are TUI-only YAML files that bundle an actor reference with pre-configured arguments, scope rules, and UI presets - Users select personas from a picker or via `/persona` command - Each session tab can have a different active persona - Personas define: display name, icon, actor reference, default arguments, scope rules, greeting message ### Reference/Command System - **Normal mode**: `@` triggers reference picker (files, actors, tools, skills) - **Command mode**: `/` triggers slash command system (plan, actor, session, etc.) - **Shell mode**: `!` enters shell command passthrough - Autocompletion, fuzzy search, and category filtering ## Acceptance Criteria - [ ] Persona YAML schema defined and parsed - [ ] Persona picker UI in TUI - [ ] `/persona` command to switch personas - [ ] Per-session persona binding - [ ] `@` reference picker with autocompletion - [ ] `/` slash command system with autocompletion - [ ] `!` shell mode passthrough - [ ] Category filtering in reference picker - [ ] Fuzzy search in all pickers ## Metadata - **Commit message**: `feat(tui): implement persona system and reference/command input modes` - **Branch name**: `feature/m8-tui-personas` ## Definition of Done - Persona system loads and applies YAML configs - All 3 input modes functional - Autocompletion works in all modes

Rows
Columns