xuiltul Skill: System Management
CLI Commands (Recommended)
Use the animaworks CLI for individual Anima management. Prefer CLI over direct API calls.
# Restart individual Anima (to apply config changes, etc.)
animaworks anima restart <name>
# Status check (all or individual)
animaworks anima status
animaworks anima status <name>
# Model change (updates status.json + auto restart)
animaworks anima set-model <name> <model>
# Role change
animaworks anima set-role <name> <role>
# Anima list
animaworks anima list
# Disable / Enable
animaworks anima disable <name>
animaworks anima enable <name>
# Delete (--archive for backup)
animaworks anima delete <name>
Common Usage
# Restart specific Anima after config.json change
animaworks anima restart aoi
# Change model and auto restart
animaworks anima set-model aoi claude-sonnet-4-6
API Reference (When CLI Unavailable)
Base URL: http://localhost:18500
| Endpoint | Method | Purpose |
|---|---|---|
/api/system/status |
GET | System status check |
/api/system/reload |
POST | Hot reload all animas |
/api/animas |
GET | Anima list |
/api/animas/{name} |
GET | Anima details |
/api/animas/{name}/restart |
POST | Individual restart |
/api/animas/{name}/stop |
POST | Individual stop |
/api/animas/{name}/start |
POST | Start stopped anima |
/api/animas/{name}/chat |
POST | Send message |
/api/animas/{name}/trigger |
POST | Trigger heartbeat immediately |
Reload Procedure (After Program Update)
curl -s -X POST http://localhost:18500/api/system/reload | python3 -m json.tool
added: Newly detected animasrefreshed: Reloaded animas (file changes applied)removed: Animas removed from disk- No server restart needed. Config and prompt changes take effect immediately via this endpoint
Notes
- Stopping a worker does not delete anima data (memory, settings)
- Do not perform operations that stop yourself
- Use CLI → API priority for individual operations