animaworks-guide

AnimaWorks CLI Complete Reference

All AnimaWorks operations are performed via the animaworks command. This skill is a complete reference for all subcommands, arguments, and examples.

For operational concepts and rules, see common_knowledge/:

• Messaging rules → communication/messaging-guide.md
• Task management → operations/task-management.md
• Tool system → operations/tool-usage-overview.md
• Organization structure → reference/organization/structure.md
• Model selection and config → reference/operations/model-guide.md

---

Server Operations (Generally Avoid)

animaworks start                         # Start server (default: 0.0.0.0:18500)
animaworks start --port 8080             # Specify port
animaworks start --foreground            # Foreground mode (for debugging)
animaworks stop                          # Stop server
animaworks restart                       # Restart server
animaworks status                        # Check system state (processes, Anima list)
animaworks reset                         # Delete runtime directory + reinitialize
animaworks reset --restart               # Reset then auto-start server

---

Anima Management (anima subcommand)

List, Status, and Info

animaworks anima list                    # List all Anima (name, enabled, model, supervisor)
animaworks anima list --local            # Scan filesystem directly (no API)
animaworks anima status                  # All Anima process states (State, Model, PID, Uptime)
animaworks anima status {name}           # Specific Anima process state
animaworks anima info {name}             # Detailed config (model, role, credential, voice, etc.)
animaworks anima info {name} --json      # JSON output

anima info output includes:

• Anima name, Enabled, Role, Model, Execution Mode
• Credential, Fallback Model, Max Turns, Max Chains
• Context Threshold, Max Tokens, LLM Timeout
• Thinking settings, Supervisor, Mode S Auth
• Voice settings (tts_provider, voice_id, speed, pitch)