CLI 인터페이스
anyy는 기본 TUI를 열며 설정, 진단, 관리, 일회성 대화용 스크립트 친화적 명령도 제공합니다.
대화형 인터페이스 시작
anyy
활성 프로필을 결정하고 상주 Gateway에 연결해 터미널 인터페이스를 엽니다. 명령 앞에서 다른 프로필·초기 역할을 선택하세요.
anyy --profile personal --role research
알려진 세션을 직접 재개합니다.
anyy --resume SESSION_ID
대화형 명령·키보드는 TUI를 참조하세요.
프롬프트 하나 전송
TUI 없이 스크립트·프로그램에서 응답 하나가 필요하면 anyy chat을 사용하세요.
anyy chat "Summarize my current tasks"
기존 대화에 새 프롬프트는 --session을 씁니다.
anyy chat --session SESSION_ID "What should I do next?"
--session은 새 프롬프트가 이력을 사용할 대화를 선택합니다. 바쁘면 후속 대기열에 들어갑니다. TUI에서 기존 세션 열기는 anyy --resume SESSION_ID입니다.
기계 판독은 --json입니다. 상태 변경을 포함한 활성 도구는 상주 Gateway로 직접 실행합니다. 대기 입력·중단은 세션을 참조하세요.
나중에 다른 프롬프트가 같은 세션을 써도 원래 제출 입력과 실제 실행을 기다리고 그 실행의 기록 결과를 읽습니다. 성공 --json에는 submission_id, agent_run_id, outcome, 응답 텍스트가 포함됩니다. 결과 필드를 참조하세요.
확인 질문이 필요하면 상태 1로 종료하고 중간 답은 출력하지 않습니다. TUI·Dashboard에서 답하세요. 실패·중단·지운 대기 입력도 0 아닌 종료입니다. 대기 시간 초과·취소는 대기만 끝내며 수락 프롬프트를 철회하지 않습니다. 재제출 전에 세션을 확인하세요.
anyy chat은 상주 Gateway로 전송합니다. 연결 불가면 anyy gateway status로 확인하세요.
대화 도구 선택
기본 TUI와 chat 진입점은 도구 이름을 받습니다.
anyy --tools '+codemode,+tool_search'
anyy chat --session SESSION_ID --tools 'read,bash' "Inspect the project"
이름/패턴과 정확한 +name/-name 수정 목록은 별도 형식입니다. --exclude-tools는 제거, --tools ''는 명시 빈 허용 목록입니다. Go CLI는 Pi의 선택 --no-tools builtin 대신 별도 불리언 --no-tools, --no-builtin-tools를 씁니다. 정확한 참조를 참조하세요.
새 세션은 생성 시 선택을 받습니다. 기존 세션의 명시 플래그는 프롬프트 수용 전에 구성하며 바쁘거나 대기 작업이 있으면 충돌하고 새 프롬프트를 제출하지 않습니다. 재정의가 없으면 실행 세션은 활성 이름을 유지합니다. 원시 콜드/분기 복원은 새 SDK형 초기 선택 대신 표준 선언을 읽습니다.
Codemode on/only는 프로필 설정이며 역할 변경이 도구를 선택하지 않습니다. 도구 검색 활성은 해당 세션 후속 요청에 적용됩니다. 다시 로드·복원은 세션을 참조하세요.
올바른 프로필 선택
전역 선택 플래그는 명령 앞에 둡니다.
anyy --profile work status
anyy --profile work chat "Show today's priorities"
| 플래그 | 목적 |
|---|---|
--profile NAME | 이름 있는 프로필 선택 |
--profile-root PATH | 다른 프로필 루트 사용 |
--role ROLE | 새 세션 초기 역할 |
--home PATH | 지원 명령의 프로필 홈 지정 |
--socket PATH | 지원 Gateway 소켓 재정의 |
--no-color | 터미널 색상 끄기 |
일상에는 --profile을 권장합니다. --home, --socket은 진단·명시적 비표준 구성에 쓰세요.
명령 그룹
| 목표 | 명령 |
|---|---|
| 구성 | anyy setup, anyy setup model, anyy setup channel |
| 상태 확인 | anyy status, anyy doctor, anyy config |
| 상주 관리 | anyy gateway start|restart|status|stop |
| 웹 열기 | anyy dashboard |
| 기능 관리 | anyy tools |
| 예약 관리 | anyy cron, anyy heartbeat status |
| 데이터 보호·유지 | anyy backup, anyy maintenance |
설치 카탈로그는 anyy --help, 낯선 플래그는 anyy COMMAND --help를 먼저 실행하세요.
셸 스크립트
제공하면 JSON을 사용하세요.
anyy status --json
anyy backup list --json
anyy heartbeat status --json
JSON은 단일 구조화 결과를 기록하며 파싱에 안정적입니다. 사람 출력은 기호·색을 쓸 수 있습니다.
문제 해결
| 증상 | 조치 |
|---|---|
anyy가 잘못된 데이터 열림 | 명령 앞 --profile NAME과 anyy status 확인 |
| 일회성 채팅 연결 불가 | anyy gateway status 후 anyy gateway start |
| 플래그 거부 | 정확한 하위 명령 --help. 모두 전역은 아님 |
| 스크립트가 형식 출력에 깨짐 | 사람 출력 파싱 대신 --json |
전체는 CLI 명령 참조를 참조하세요.