xuiltul 스킬: 시스템 관리
CLI 명령어 (권장)
animaworks CLI로 개별 Anima 관리가 가능합니다. API 직접 호출보다 CLI를 우선하세요.
# 개별 Anima 재시작 (설정 변경 반영 등)
animaworks anima restart <name>
# 상태 확인 (전체 또는 개별)
animaworks anima status
animaworks anima status <name>
# 모델 변경 (status.json 업데이트 + 자동 재시작)
animaworks anima set-model <name> <model>
# 역할 변경
animaworks anima set-role <name> <role>
# Anima 목록
animaworks anima list
# 비활성화 / 활성화
animaworks anima disable <name>
animaworks anima enable <name>
# 삭제 (--archive로 백업 가능)
animaworks anima delete <name>
일반적인 사용법
# config.json 변경 후 특정 Anima만 재시작
animaworks anima restart aoi
# 모델 변경 및 자동 재시작
animaworks anima set-model aoi claude-sonnet-4-6
API 레퍼런스 (CLI를 사용할 수 없는 경우)
베이스 URL: http://localhost:18500
| 엔드포인트 | 메서드 | 용도 |
|---|---|---|
/api/system/status |
GET | 시스템 상태 확인 |
/api/system/reload |
POST | 전체 anima 핫 리로드 |
/api/animas |
GET | anima 목록 |
/api/animas/{name} |
GET | anima 상세 |
/api/animas/{name}/restart |
POST | 개별 재시작 |
/api/animas/{name}/stop |
POST | 개별 정지 |
/api/animas/{name}/start |
POST | 정지된 anima 시작 |
/api/animas/{name}/chat |
POST | 메시지 전송 |
/api/animas/{name}/trigger |
POST | heartbeat 즉시 실행 |
리로드 절차 (프로그램 업데이트 후)
curl -s -X POST http://localhost:18500/api/system/reload | python3 -m json.tool
added: 새로 감지된 animarefreshed: 재로드된 anima (파일 변경 사항이 반영됩니다)removed: 디스크에서 삭제된 anima- 서버 재시작이 필요 없습니다. 이 엔드포인트로 설정 및 프롬프트 변경이 즉시 반영됩니다
주의사항
- 워커를 정지해도 anima 데이터(기억, 설정)는 유지됩니다
- 자기 자신을 정지하는 작업은 수행하지 마세요
- 개별 작업은 CLI → API 순서로 우선하여 사용합니다