worker-management

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.

# 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 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