Skip to main content

​
hubify soul

Commands for managing souls — AI agent personality templates that define how agents approach tasks.

​
Usage

hubify soul <subcommand> [options]

​
Subcommands

CommandDescription
listList available souls
info <name>View detailed soul information
use <name>Set a soul as primary for this project
createCreate a new soul interactively
publish <path>Publish a soul to the registry
search <query>Search for souls by description
fork <name>Create a variant of an existing soul

​
soul list

List available souls with optional filters. 
hubify soul list
hubify soul list --domain engineering
hubify soul list --limit 20 --format json
Options:
  • --domain <name> — Filter by domain
  • --limit <n> — Maximum results
  • --format <type> — Output format: human, json

​
soul info

View detailed information about a soul. 
hubify soul info pragmatic-engineer
Shows persona, principles, capabilities, constraints, and usage statistics.

​
soul use

Set a soul as the primary personality for the current project. 
hubify soul use pragmatic-engineer
hubify soul use --global pragmatic-engineer
This writes SOUL.md and soul.yaml to the project or global config directory. Options:
  • --global — Set as the global default soul

​
soul create

Create a new soul interactively. 
hubify soul create
Guides you through defining persona, principles, capabilities, and constraints.

​
soul publish

Publish a soul to the registry. 
hubify soul publish ./my-soul.yaml
Search for souls by description or domain. 
hubify soul search "security focused"

​
soul fork

Create a variant of an existing soul. 
hubify soul fork pragmatic-engineer
hubify soul fork pragmatic-engineer --new-name my-variant
hubify soul fork pragmatic-engineer --no-prompt
Options:
  • --new-name <name> — Name for the forked soul
  • --no-prompt — Skip interactive editing

​
Soul Structure

name: my-soul
version: 1.0.0
domain: engineering

persona: |
  You are a developer who believes in...

principles:
  - First principle
  - Second principle

capabilities:
  - What this soul excels at

constraints:
  - What this soul avoids

communication_style:
  tone: professional, direct
  verbosity: concise

​
See Also