CLI 명령 참조

하위 명령 없이 anyy는 TUI를 엽니다. 공개 명령은 선택 프로필·상주 Gateway를 구성·운영합니다.

전역 진입점

anyy [--profile NAME] [--profile-root PATH] [--role ROLE]
anyy [--profile NAME] [--profile-root PATH] [--role ROLE] COMMAND
anyy --version
anyy --resume SESSION_ID

--profile, --profile-root, --role, --no-color 등 선택기는 명령 앞입니다. 기본 TUI의 --home, --socket, --resume는 anyy 바로 뒤, 하위 명령의 지원 --home·--socket은 그 뒤입니다. 명령 앞에 두면 거부합니다.

플래그	목적
`--profile NAME`	이름 프로필
`--profile-root PATH`	관리자 기본 루트
`--role ROLE`	새 대화 초기 역할
`--resume ID`	TUI 기존 세션
`--home PATH`	TUI 홈 또는 지원 명령 뒤 재정의
`--socket PATH`	TUI 소켓 또는 지원 명령 뒤 재정의
`--no-color`	색 끄기
`--version`	버전

정확 플래그는 anyy COMMAND --help입니다.

채팅과 상태

`anyy` / `--resume`

anyy
anyy --resume SESSION_ID

터미널을 열고 선택적으로 재개합니다.

`anyy chat`

anyy chat [--home PATH] [--socket PATH] [--role ROLE] \
  [--session ID] [--json] PROMPT

실행 상주 Gateway로 새 프롬프트 하나를 보냅니다. --session이 기존 대화를 고르고 바쁘면 후속 대기합니다. --json 구조 출력과 활성 도구 직접 실행을 지원합니다. TUI 재개는 anyy --resume ID이며 세션을 참조하세요.

성공 JSON:

필드	의미
`session_id`	입력 수신 대화
`submission_id`	결과 대기 원래 수락 입력
`execution_id`	재사용 세션 레인
`agent_run_id`	답을 공급한 실제 실행
`execution_state`	관찰 레인. 완료 보통 `idle`
`outcome`	해당 호출 결과. `succeeded` 성공
`stop_reason`	완료·실패 분류
`assistant_text`	해당 실행 기록 메시지의 보이는 답

유휴만으로 성공이 아닙니다. 확인 질문 suspended, 실패, 중단, 지운 입력, 제한 시간은 중간 답 없이 0 아닌 종료입니다. 제한 시간·호출자 취소는 관찰만 끝냅니다. 원래 제출을 유지하며 최신 세션 메시지로 대체하지 않습니다. CLI를 참조하세요.

대화 도구 선택

기본 TUI·chat의 세션 선택 플래그이며 Gateway·프로필 기본값을 바꾸지 않습니다.

플래그	의미
`--tools LIST`, `-t LIST`	쉼표 이름/패턴 또는 기본값 수정 정확 `+name`/`-name`
`--exclude-tools LIST`, `-xt LIST`	제외 이름/패턴
`--no-tools`, `-nt`	모든 기본 활성 억제
`--no-builtin-tools`, `-nbt`	기본 제공만 억제, 확장 기본은 유지

anyy --tools '+codemode,+tool_search'
anyy chat --tools 'read,bash' --exclude-tools 'bash' "Inspect this project"
anyy chat --session SESSION_ID --tools '' "Answer without tools"

일반 패턴은 *를 지원합니다. 수정 목록은 일반 이름과 혼합·와일드카드 수정 불가입니다. --tools ''는 빈 허용, --exclude-tools ''는 제외 재정의 지우기입니다. 프롬프트 앞에 두며 chat 앞·뒤 모두 가능하지만 로컬 목록이 전역 해당 목록을 대체합니다. 관리 명령에서는 거부됩니다.

별도 Go 불리언입니다. 기본 제공은 --no-builtin-tools이며 Pi --no-tools builtin은 미지원입니다. 둘 다면 --no-tools가 우선입니다. Codemode on/only 모드는 프로필 설정이며 --codemode-mode는 없습니다.

새 세션은 session.new의 tool_selection, 기존은 먼저 session.tools.configure입니다. 활성·대기·수용·요약 작업이면 충돌하고 새 입력은 제출하지 않습니다. 재정의 없는 실행 세션 연결은 활성 이름 유지입니다. 콜드 원시 복원·분기는 표준 선언을 쓰며 SDK식 명시 초기 선택과 다릅니다.

복원·리소스·설정은 세션을 참조하세요.

로컬 프롬프트 진단

anyy prompt eval local --authorize-live

격리 임시 세션에서 활성 프로필 모델에 실제 유료일 수 있는 요청을 합니다. 응답·실제 사용·지연과 비공개 보고서를 기록합니다. --home PATH는 프로필, --output PATH는 한 번만 쓸 경로입니다. 터미널·보고서를 비공개로 하세요. 채널·cron을 시작하거나 품질 평가·Pi 인증은 하지 않습니다.

`anyy status`

anyy status [--home PATH] [--socket PATH] [--json]

선택 프로필·Gateway·런타임을 보고합니다.

`anyy doctor`

anyy doctor [--home PATH] [--config PATH] [--json]

구성·런타임 진단입니다.

`anyy config`

anyy config [--home PATH] [--config PATH]

터미널 구성 대시보드로 경로, 공급자/모델, 엔드포인트, 비밀 참조를 보며 편집·비밀 노출은 하지 않습니다.

설정과 모델

`anyy setup`

anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
  [--set INPUT=VALUE] [--sensitive-fd INPUT=FD] \
  [--external-locator-fd INPUT=FD]

전체/빠른 또는 모델/채널 전용 대화형입니다. 설정을 참조하세요.

`anyy tools`

anyy tools [--home PATH] [--probe]
anyy tools list [--home PATH]
anyy tools websearch [--home PATH]
anyy tools image [--home PATH] [--probe]
anyy tools image understanding [--home PATH] [--probe]
anyy tools image generation [--home PATH] [--probe]
anyy tools video [understanding] [--home PATH] [--probe]
anyy tools voice [--home PATH] [--probe]
anyy tools voice tts [--home PATH] [--probe]
anyy tools voice stt [--home PATH] [--probe]

선택 웹·이미지·동영상·음성 백엔드입니다.

Gateway와 Dashboard

`anyy gateway`

anyy gateway start [--home PATH]
anyy gateway restart [--home PATH]
anyy gateway status [--home PATH]
anyy gateway stop [--home PATH]

상주 백그라운드 서비스 관리입니다.

`anyy dashboard`

anyy dashboard [--home PATH] [--socket PATH] [--listen ADDR] [--no-open]
anyy dashboard --status
anyy dashboard --stop

필요 시 사이드카 시작·확인·중지입니다. 개요를 참조하세요.

메시징

`anyy channel`

anyy channel doctor CHANNEL [--home PATH] [--socket PATH] [--json]
anyy channel pairing list [--channel CHANNEL] [--account ACCOUNT] [--all] [--json]
anyy channel pairing approve --request REQUEST
anyy channel pairing approve --prompt-code --channel CHANNEL --account ACCOUNT
anyy channel pairing approve --code-stdin --channel CHANNEL --account ACCOUNT
anyy channel pairing reject --request REQUEST
anyy channel pairing revoke --grant GRANT [--reason TEXT]
anyy channel reload [--home PATH] [--socket PATH] [--json]

진단, 페어링 판단, 권한 취소, 다시 로드입니다. 플랫폼을 참조하세요.

스킬과 MCP

`anyy skills`

anyy skills list [--home PATH] [--json]
anyy skills view [--home PATH] [--json] NAME [FILE_PATH]
anyy skills install [--home PATH] [--socket PATH] [--name NAME] [--force] [--now] [--json] ZIP_PATH
anyy skills uninstall [--home PATH] [--socket PATH] [--now] [--json] NAME
anyy skills rollback [--home PATH] [--socket PATH] [--revision REVISION_ID] [--now] [--json] NAME
anyy skills reload [--home PATH] [--socket PATH] [--json]

스킬 확인·설치·제거·롤백·다시 로드입니다.

`anyy mcp`

anyy mcp add SERVER_ID [--home PATH] --transport stdio --command CMD [--cwd DIR] [--env KEY=VALUE] [--disable] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --command CMD [--cwd DIR] [--exposure codemode|deferred|direct|hidden] [--tool-exposure JSON] [--description TEXT] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --url URL [--transport http] [--auth JSON] [--oauth JSON] [--header KEY=VALUE] [--exposure codemode|deferred|direct|hidden]
anyy mcp add SERVER_ID [--home PATH] --preset filesystem [-- ARG...]
anyy mcp add SERVER_ID [--home PATH] --local --url URL [--oauth JSON] [--header KEY=VALUE]
anyy mcp add SERVER_ID [--home PATH] --local --command CMD [--cwd DIR] [--env KEY=VALUE] [--args ARG...]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--exposure codemode|deferred|direct|hidden] [--enable]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--tool-exposure JSON] [--description TEXT]
anyy mcp login SERVER_ID [--home PATH] [--socket PATH] [--timeout SECONDS] [--json]
anyy mcp logout SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp remove SERVER_ID [--home PATH] [--force]
anyy mcp remove SERVER_ID [--home PATH] --local
anyy mcp enable SERVER_ID [--home PATH] [--project]
anyy mcp disable SERVER_ID [--home PATH] [--project]
anyy mcp set SERVER_ID KEY VALUE [--home PATH]
anyy mcp unset SERVER_ID KEY [--home PATH]
anyy mcp status [--home PATH] [--socket PATH] [--json]
anyy mcp list [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER.TOOL [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER_ID TOOL_NAME [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp show SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp probe SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp test SERVER_ID [--home PATH] [--socket PATH]
anyy mcp reload [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp logs [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp serve [--home PATH] [--socket PATH]

stdio·HTTP, 인증, 노출, 상태, 직접 호출입니다. 추가 전에 전송별 플래그가 다르니 anyy mcp --help를 보세요.

add는 기본 활성 지연, --disable은 끄기입니다. 선택기·필수 점검 없이 노출·순서 재정의로 구성합니다. RPC tool_exposure는 순서 JSON 문자열이며 Probe는 노출/제공 사실의 단일 tools 목록입니다.

configure --exposure/--enable은 선택 출처·기존 프로젝트 설정입니다. configure --description/--tool-exposure, set/unset은 원시 프로필입니다. 혼합을 거부하니 분리하고 show로 출처를 보세요.

add --cwd DIR은 stdio만입니다. add·set SERVER_ID cwd VALUE는 입력 상대·절대·선행 홈을 보존하며 cwd의 상대 기준은 상주 표준 워크스페이스입니다.

일반 값은 문자열·표현식을 유지하고 민감 이름이 자동 비밀 저장을 유발하지 않습니다. 프로필 env:, secret:, file:는 자체 규칙입니다.

--project는 미재정의 프로필 enable/disable에만 활성 전용 재정의를 기록합니다. --local·-l은 add/remove에만 표준 워크스페이스 .anyy/mcp.json을 씁니다. 로컬 add는 --force 없이 교체하고 remove는 프로필·권한을 유지합니다. 실행 항목을 다시 로드하지 않습니다. 프로필 구성 안의 MCP 서버 정의에 대한 일반 add/remove는 기존 확인·자격 증명 처리 동작을 유지합니다.

reload는 파일 재읽기 없이 재연결, 시작·유휴 session.reload RPC는 재읽기입니다. 로그인 --timeout 기본 300초는 인증만입니다. 구성을 참조하세요.

logout은 지원 클라이언트 자료 포함 선택 서버 로컬 OAuth를 제거하며 정의는 유지합니다. 상주 우선, 아니면 독점 오프라인이 필요합니다.

anyy mcp serve는 다른 MCP 클라이언트에 Anyy를 노출합니다. messages_send는 원래 제출을 따르고 확인 질문을 최종 답으로 주장하지 않습니다. 결과·await를 참조하세요.

자동화

`anyy cron`

anyy cron list [--home PATH] [--include-disabled] [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE --prompt TEXT \
  [--kind agent|skill|notify] [--skills LIST] [--role ROLE] [--workspace WORKSPACE] \
  [--delivery-target TARGET] [--delivery-channel CHANNEL] [--toolsets LIST] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE --kind script --script NAME \
  [--workdir PATH] [--role ROLE] [--workspace WORKSPACE] [--delivery-target TARGET] [--json]
anyy cron update [--home PATH] --id ID [--enable|--disable] [--schedule SCHEDULE] [--prompt TEXT] \
  [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron delete [--home PATH] --id ID [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]

agent·skill·script·notify를 만듭니다. 명시 종류가 없으면 --script가 script를 선택하고 그 외 기본은 agent입니다. agent/skill/notify는 --prompt, script는 --script가 필요합니다. 대상은 gateway, origin, current_user_default, none이며 요건을 따릅니다. 역할·워크스페이스·페이로드·경로를 유지합니다.

`anyy heartbeat`

anyy heartbeat status [--home PATH] [--json]

상주 Heartbeat 상태입니다.

프로필과 역할

`anyy profile`

anyy profile list [--json]
anyy profile get NAME [--json]
anyy profile create NAME [--display-name NAME] [--json]
anyy profile use NAME [--json]
anyy profile delete NAME --force [--purge-secrets] [--json]

격리 홈 관리이며 삭제는 파괴적이고 --force가 필요합니다.

`anyy role`

anyy role list [--home PATH] [--include-archived] [--json]
anyy role get [--home PATH] ROLE_ID [--json]
anyy role create [--home PATH] ROLE_ID [--display-name NAME] [--json]
anyy role update [--home PATH] ROLE_ID [--display-name NAME] [--soul-file PATH] [--json]
anyy role use [--home PATH] ROLE_ID [--json]
anyy role delete [--home PATH] ROLE_ID [--json]

비서 역할·Soul 관리입니다.

백업, 유지보수, 릴리스 수명

`anyy backup`

anyy backup create [--home PATH] [--output PATH] [--include-secrets] [--json]
anyy backup restore --archive PATH --target-home PATH [--json]
anyy backup list [--home PATH] [--json]

생성·목록·복원입니다. --include-secrets는 관리 secrets/·mcp/oauth/를 추가합니다. 구성·워크스페이스 인라인 비밀은 없어도 들어가며 전체 가림은 아닙니다. 모든 아카이브를 민감 비공개로 보호하세요. 백업을 참조하세요.

`anyy maintenance`

anyy maintenance compact-state [--home PATH] (--output PATH | --replace) [--temp-dir PATH] [--json]
anyy maintenance checkpoint-state [--home PATH] [--json]
anyy maintenance cache-token-estimates [--home PATH] [--limit N] [--execute] [--json]

DB·토큰 추정 유지보수입니다. 상태 교체 전에 검증 백업을 두세요.

`anyy update`

anyy update [--home PATH] [--version VERSION] [--base-url URL]
anyy update --compact [--home PATH] [--version VERSION] [--base-url URL]
anyy update --check [--home PATH] [--version VERSION] [--base-url URL]

네이티브 상주 확인·업데이트입니다. 업데이트와 제거를 참조하세요.

`anyy uninstall`

anyy uninstall
anyy uninstall --keep-data --yes
anyy uninstall --full --yes
anyy uninstall --home PATH --keep-data --yes

네이티브 제거입니다. --yes·-y 전에 --keep-data·--full 하나를 고르며 둘은 동시 불가입니다. --home PATH는 설치 홈, --full은 범위 전체 데이터도 지우므로 먼저 백업하세요.

전역 진입점​

채팅과 상태​

anyy / --resume​

anyy chat​

대화 도구 선택​

로컬 프롬프트 진단​

anyy status​

anyy doctor​

anyy config​

설정과 모델​

anyy setup​

anyy tools​

Gateway와 Dashboard​

anyy gateway​

anyy dashboard​

메시징​

anyy channel​

스킬과 MCP​

anyy skills​

anyy mcp​

자동화​

anyy cron​

anyy heartbeat​

프로필과 역할​

anyy profile​

anyy role​

백업, 유지보수, 릴리스 수명​

anyy backup​

anyy maintenance​

anyy update​

anyy uninstall​