Hubify Docs
hubify soul
Manage AI agent personalities
hubify soul
Commands for managing souls (AI agent personality templates).
Usage
hubify soul <subcommand> [options]
Subcommands
| Command | Description |
|---|---|
list | List available souls |
info <name> | View soul details |
create | Create a new soul |
fork <name> | Fork an existing soul |
publish | Publish a soul |
apply <name> | Apply a soul to current session |
Examples
List Souls
hubify soul list
Output:
Available Souls (1,247 total)
pragmatic-engineer (v1.0.0)
Senior engineer focused on maintainability
Used by: 2,341 agents
creative-architect (v2.1.0)
Innovative solutions for complex problems
Used by: 1,892 agents
security-focused (v1.3.0)
Security-first approach to development
Used by: 1,456 agents
rapid-prototyper (v1.1.0)
Fast iteration and experimentation
Used by: 987 agents
Filter by Category
hubify soul list --category engineering
View Soul Details
hubify soul info pragmatic-engineer
Output:
Soul: pragmatic-engineer v1.0.0
Author: @houstongolden
Category: engineering
Used by: 2,341 agents
Persona:
You are a senior software engineer with 15 years of experience.
You value maintainability over cleverness and always consider
the long-term implications of technical decisions.
Principles:
- Prefer simple solutions over clever ones
- Consider maintenance costs in every decision
- Document the "why", not just the "what"
- Optimize for readability first, performance second
Capabilities:
- Code review with architectural context
- Refactoring for maintainability
- Technical debt assessment
- System design for scale
Constraints:
- Will not sacrifice maintainability for speed
- Avoids premature optimization
Create New Soul
hubify soul create
Interactive wizard:
Creating new soul...
? Soul name: my-custom-soul
? Category: engineering
? One-line description: Focused on clean, tested code
? Define persona (describe the agent's identity):
You are a developer who believes that...
? Add a principle: Always write tests first
? Add another principle? (y/n) y
? Add a principle: Prefer composition over inheritance
? Add another principle? (y/n) n
? Add a capability: Test-driven development
? Add another capability? (y/n) n
Created: .hubify/souls/my-custom-soul.yaml
Fork Existing Soul
hubify soul fork pragmatic-engineer --name my-pragmatic-variant
Output:
Forking pragmatic-engineer...
Created: .hubify/souls/my-pragmatic-variant.yaml
Edit the soul, then publish with:
hubify soul publish ./my-pragmatic-variant.yaml
Publish Soul
hubify soul publish ./my-soul.yaml
Output:
Publishing my-soul...
Validating... ✓
Uploading... ✓
Indexing... ✓
Published: my-soul@1.0.0
View at: https://hubify.com/souls/my-soul
Apply Soul
hubify soul apply pragmatic-engineer
Output:
Applying soul: pragmatic-engineer
Loaded persona and principles.
This soul will influence agent behavior until:
- Session ends
- Another soul is applied
- Run: hubify soul clear
Clear Active Soul
hubify soul clear
Soul Structure
name: my-soul
version: 1.0.0
author: "@username"
category: engineering
description: Brief description
persona: |
You are a developer who believes in...
principles:
- First principle
- Second principle
- Third principle
capabilities:
- What this soul excels at
- Another capability
constraints:
- What this soul avoids
- Boundaries
communication_style:
tone: professional, direct
verbosity: concise
examples: uses concrete code examples
Categories
| Category | Description |
|---|---|
engineering | Software development focus |
creative | Innovative and experimental |
security | Security-first approach |
research | Analysis and exploration |
mentoring | Teaching and guidance |
specialized | Domain-specific expertise |
Combining with Skills
Souls influence how skills are interpreted:
# Apply a soul
hubify soul apply pragmatic-engineer
# Use skills with that personality
hubify execute typescript-strict-mode
The pragmatic-engineer soul will emphasize maintainability when applying the TypeScript skill.