xuiltul

worker-management

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"

xuiltul 254 45 Updated 3mo ago
GitHub

Install

npx skillscat add xuiltul/animaworks/worker-management

Install via the SkillsCat registry.

SKILL.md

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