cortex soul

Manage agent souls (personas) that define the personality, tone, and behavior of Cortex agents. Souls provide consistent character traits, communication styles, and behavioral patterns.

Usage

cortex soul <subcommand> [options]

Subcommands

SubcommandDescription
initInitialize a new soul configuration
showDisplay current soul configuration
editEdit a soul configuration
noteAdd a personality note to a soul
templatesList available soul templates
apply-templateApply a predefined soul template
validateValidate a soul configuration

Options

OptionSubcommandDescription
--forceinitOverwrite existing soul configuration

Soul Templates

Prebuilt soul templates provide starting points for agent personalities:

  • professional — Professional assistant
  • friendly — Friendly companion
  • developer — Code reviewer / developer
  • creative — Creative writer
  • analyst — Data analyst
  • teacher — Technical teacher / support
  • minimalist — Minimalist / concise
  • custom — Build your own

Examples

# Initialize a new soul
cortex soul init

# View current soul
cortex soul show

# List available templates
cortex soul templates

# Apply a template
cortex soul apply-template "code-reviewer"

# Add a personality note
cortex soul note

# Validate soul configuration
cortex soul validate