| name | worker-management |
| description | Skill for operating and managing AnimaWorks server processes. Perform hot reload (server reload) after code updates, Anima process restart, and server status checks (list of running Anima, memory usage). "Reload", "Apply updates", "Refresh", "System status", "Server restart", "Process check" |
Skill: System Management
CLI Commands (Recommended)
Use the animaworks CLI for individual Anima management. Prefer CLI over direct API calls.
animaworks anima restart <name>
animaworks anima status
animaworks anima status <name>
animaworks anima set-model <name> <model>
animaworks anima set-role <name> <role>
animaworks anima list
animaworks anima disable <name>
animaworks anima enable <name>
animaworks anima delete <name>
Common Usage
animaworks anima restart aoi
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 animas
refreshed: 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