persona-commands

Runtime In-Chat Commands

This skill handles 11 runtime commands for AI Persona OS, routing user requests to appropriate system actions.

Command Reference

Command	Action	Output Format
status	Run health checks, display dashboard	📊 Status Dashboard with 🟢🟡🔴 indicators
show persona	Read and format SOUL.md	🪪 Persona Identity Display
show memory	Display MEMORY.md contents	Raw memory file contents
health check	Run diagnostics script	Script output with pass/fail indicators
security audit	Run security validation	Script output with security findings
show config	Validate configuration files	Script output with config validation
help	Display command reference	This table
checkpoint	Save context snapshot	Confirmation with file path
advisor on	Enable proactive mode	Confirmation message
advisor off	Disable proactive mode	Confirmation message
switch preset	Change persona configuration	Preset menu, delegate to persona-setup

Natural Language Recognition

The skill recognizes natural language variants:

• "how's my system" / "system status" / "check status" → status
• "what's my persona" / "who am I" / "show identity" → show persona
• "what do I remember" / "show my memory" / "memory contents" → show memory
• "run diagnostics" / "check health" / "system check" → health check
• "check security" / "audit security" / "security check" → security audit
• "validate config" / "check config" / "show configuration" → show config
• "what can I do" / "available commands" / "command list" → help
• "save progress" / "create checkpoint" / "save state" → checkpoint
• "enable advisor" / "turn on advisor" / "proactive on" → advisor on
• "disable advisor" / "turn off advisor" / "proactive off" → advisor off
• "change persona" / "switch configuration" / "change preset" → switch preset

Implementation Guide

Phase 1: Command Recognition

Step 1.1: Parse user input to identify command intent

command = extract_command(user_input)
if command not in VALID_COMMANDS:
    command = match_natural_language_variant(user_input)
if command is None:
    show_help_and_suggest_closest_match()
    exit

Step 1.2: Validate command availability

if command requires script:
    check script exists at ${CLAUDE_PLUGIN_ROOT}/scripts/
if command requires workspace file:
    check file exists at ~/workspace/

Phase 2: Command Execution

Step 2.1: status - Display system health dashboard

# Run health checks
core_files_count = count files in ${CLAUDE_PLUGIN_ROOT}/core/
memory_size = stat ~/workspace/MEMORY.md | get size in KB
recent_logs = count lines in ~/workspace/.logs/YYYY-MM-DD.log (last 24h)
version = cat ${CLAUDE_PLUGIN_ROOT}/VERSION

# Calculate health indicators
core_health = 🟢 if core_files_count >= 8 else 🟡 if >= 6 else 🔴
memory_health = 🟢 if memory_size < 100 else 🟡 if < 500 else 🔴
logs_health = 🟢 if recent_logs < 100 else 🟡 if < 500 else 🔴

# Display dashboard
output = format_status_dashboard(core_health, memory_health, logs_health, version)

Status Dashboard Format:

📊 AI Persona OS - Status Dashboard
🫀 Last heartbeat: YYYY-MM-DD HH:MM:SS

Core System:     🟢 8 files loaded
Memory:          🟢 42 KB (healthy)
Recent Logs:     🟡 127 entries (24h)
Version:         v0.3.0-alpha

System Status: HEALTHY

Step 2.2: show persona - Display identity from SOUL.md

soul_content = Read(~/workspace/SOUL.md)
extract:
    - name (from # heading or name: field)
    - role (from role: field or Role: heading)
    - values (from Values: section, list items)
    - style (from Communication Style: section)

output = format_persona_display(name, role, values, style)

Show Persona Format:

🪪 Persona Identity

Name:   Senior Technical Architect
Role:   System design expert specializing in distributed systems

Core Values:
  • Clarity over cleverness
  • Test everything that matters
  • Documentation is love for future you

Communication Style:
  Direct, technical, assumes expertise. Uses precise terminology.
  Proactive with suggestions. Explains reasoning when asked.

Step 2.3: show memory - Display MEMORY.md contents

memory_content = Read(~/workspace/MEMORY.md)
display memory_content with minimal formatting

Step 2.4: health check - Run diagnostics script

result = Bash("${CLAUDE_PLUGIN_ROOT}/scripts/health-check.sh")
display result
# Do not show raw exec commands unless user explicitly asks

Step 2.5: security audit - Run security validation

result = Bash("${CLAUDE_PLUGIN_ROOT}/scripts/security-audit.sh")
display result
# Highlight any security findings

Step 2.6: show config - Validate configuration

result = Bash("${CLAUDE_PLUGIN_ROOT}/scripts/config-validator.sh")
display result
# Show validation status for each config file

Step 2.7: help - Display command reference

display COMMAND_REFERENCE_TABLE (from section above)
add usage examples:
    "Type 'status' to see system health"
    "Type 'show persona' to view your identity"
    "Type 'checkpoint' to save your current context"

Step 2.8: checkpoint - Save context snapshot

timestamp = current_timestamp (HH:MM)
date = current_date (YYYY-MM-DD)
checkpoint_file = ~/workspace/memory/${date}.md

# Calculate context percentage (estimate based on conversation length)
context_percentage = min(100, conversation_turns * 5)

# Gather checkpoint data
active_task = ask_user("What task are you currently working on?")
key_decisions = ask_user("Any key decisions or changes to note?")
resume_from = ask_user("What should you resume from next session?")

# Write checkpoint
checkpoint_content = format_checkpoint(
    timestamp, context_percentage, active_task, key_decisions, resume_from
)
Write(checkpoint_file, checkpoint_content, mode=append)

confirm "Checkpoint saved to ${checkpoint_file}"

Checkpoint Format:

## Checkpoint [14:32] — Context: 35%

**Active task:** Implementing user authentication flow
**Key decisions:**
- Chose JWT over session cookies for API statelessness
- Added rate limiting at gateway level

**Resume from:** Complete integration tests for /auth/login endpoint

Step 2.9: advisor on - Enable proactive mode

# Set proactive mode flag (in SOUL.md or runtime state)
confirm "✅ Proactive advisor mode ENABLED"
confirm "I will now offer suggestions and anticipate needs proactively."

Step 2.10: advisor off - Disable proactive mode

# Clear proactive mode flag
confirm "✅ Proactive advisor mode DISABLED"
confirm "I will wait for explicit requests before offering suggestions."

Step 2.11: switch preset - Change persona configuration

# Display preset menu
presets = Glob("${CLAUDE_PLUGIN_ROOT}/presets/*.yaml")
display_menu(presets)

# Delegate to persona-setup skill
confirm "Switching to persona-setup skill for preset configuration..."
# The persona-setup skill will handle preset selection and file rebuilding

Phase 3: Output Formatting

Step 3.1: Apply command-specific formatting rules

if command == "status":
    use traffic light indicators (🟢🟡🔴)
    include timestamp and version
else if command == "show persona":
    use identity header (🪪)
    format as sections with bullet lists
else if command == "checkpoint":
    use markdown heading with timestamp
    include context percentage
else if command in ["health check", "security audit", "show config"]:
    display script output directly
    highlight warnings and errors
else:
    use minimal formatting

Step 3.2: Never show raw execution commands unless explicitly requested

# BAD: showing raw commands
"Running: /path/to/script.sh --flag"

# GOOD: showing results
"Health Check Results:
  ✓ Core files present
  ✓ Memory within limits
  ⚠ Log rotation needed"

Key Rules

1. Natural Language Recognition: Recognize common variants of each command
2. Clean Output: Never show raw exec commands unless user explicitly asks
3. Script Paths: All scripts referenced via ${CLAUDE_PLUGIN_ROOT}/scripts/
4. Workspace Paths: All user data files in ~/workspace/ or ~/workspace/memory/
5. Formatting: Use emoji indicators (🟢🟡🔴) for health, (🪪) for persona, (📊) for dashboard
6. Checkpoint Timestamps: Always include HH:MM timestamp and context percentage
7. Delegation: For complex operations (like switch preset), delegate to appropriate skill
8. Error Handling: If command fails, show helpful error message and suggest alternatives
9. Help Accessibility: Make help command easily discoverable and comprehensive
10. Proactive Mode: advisor on/off should clearly confirm state change

Error Scenarios

Missing Script:

❌ Error: health-check.sh not found at ${CLAUDE_PLUGIN_ROOT}/scripts/
Suggestion: Run 'hiivmind-openclaw-os setup' to initialize the plugin

Missing Workspace File:

❌ Error: SOUL.md not found at ~/workspace/
Suggestion: Run 'persona-setup' to create your persona configuration

Unrecognized Command:

❌ Unknown command: "statsu"
Did you mean: status?
Type 'help' to see all available commands.

Integration with Other Skills

• persona-setup: Delegates preset switching
• persona-coder: May trigger checkpoints before major refactoring
• persona-health: Called by health check command
• persona-security: Called by security audit command

Examples

User: "how's my system" Action: Run status command, display dashboard with health indicators

User: "save my progress" Action: Run checkpoint command, prompt for active task/decisions/resume point

User: "turn on advisor mode" Action: Enable proactive mode, confirm activation

User: "what can I do" Action: Display help command with full command reference table