CLI 참조

이 페이지는 현재 CLI 동작을 설명합니다. 명령이 변경되면 이 문서를 업데이트하세요.

명령 페이지

전역 플래그

  • --dev: ~/.mayros-dev 아래에 상태를 격리하고 기본 포트를 이동합니다.
  • --profile <name>: ~/.mayros-<name> 아래에 상태를 격리합니다.
  • --no-color: ANSI 색상을 비활성화합니다.
  • --update: mayros update의 약칭 (소스 설치만).
  • -V, --version, -v: 버전을 출력하고 종료합니다.

출력 스타일링

  • ANSI 색상 및 진행률 표시기는 TTY 세션에서만 렌더링됩니다.
  • OSC-8 하이퍼링크는 지원되는 터미널에서 클릭 가능한 링크로 렌더링됩니다. 그렇지 않으면 일반 URL로 폴백합니다.
  • --json (및 지원되는 경우 --plain)은 깨끗한 출력을 위해 스타일링을 비활성화합니다.
  • --no-color는 ANSI 스타일링을 비활성화합니다. NO_COLOR=1도 존중됩니다.
  • 장기 실행 명령은 진행률 표시기를 표시합니다 (지원되는 경우 OSC 9;4).

색상 팔레트

Mayros는 CLI 출력에 lobster 팔레트를 사용합니다.

  • accent (#FF5A2D): 제목, 레이블, 기본 강조.
  • accentBright (#FF7A3D): 명령 이름, 강조.
  • accentDim (#D14A22): 보조 강조 텍스트.
  • info (#FF8A5B): 정보 값.
  • success (#2FBF71): 성공 상태.
  • warn (#FFB020): 경고, 폴백, 주의.
  • error (#E23D2D): 오류, 실패.
  • muted (#8B7F77): 강조 해제, 메타데이터.

팔레트 진실의 공급원: src/terminal/palette.ts (일명 "lobster seam").

명령 트리

mayros [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
  doctor
  security
    audit
  reset
  uninstall
  update
  channels
    list
    status
    logs
    add
    remove
    login
    logout
  skills
    list
    info
    check
  plugins
    list
    info
    install
    enable
    disable
    doctor
  memory
    status
    index
    search
  message
  agent
  agents
    list
    add
    delete
  acp
  status
  health
  sessions
  gateway
    call
    health
    status
    probe
    discover
    install
    uninstall
    start
    stop
    restart
    run
  logs
  system
    event
    heartbeat last|enable|disable
    presence
  models
    list
    status
    set
    set-image
    aliases list|add|remove
    fallbacks list|add|remove|clear
    image-fallbacks list|add|remove|clear
    scan
    auth add|setup-token|paste-token
    auth order get|set|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
  devices
  node
    run
    status
    install
    uninstall
    start
    stop
    restart
  approvals
    get
    set
    allowlist add|remove
  browser
    status
    start
    stop
    reset-profile
    tabs
    open
    focus
    close
    profiles
    create-profile
    delete-profile
    screenshot
    snapshot
    navigate
    resize
    click
    type
    press
    hover
    drag
    select
    upload
    fill
    dialog
    wait
    evaluate
    console
    pdf
  hooks
    list
    info
    check
    enable
    disable
    install
    update
  webhooks
    gmail setup|run
  pairing
    list
    approve
  docs
  dns
    setup
  tui

참고: 플러그인은 추가 최상위 명령을 추가할 수 있습니다 (예: mayros voicecall).

보안

  • mayros security audit — 일반적인 보안 실수에 대한 구성 + 로컬 상태 감사.
  • mayros security audit --deep — 최선의 노력 라이브 Gateway 프로브.
  • mayros security audit --fix — 안전한 기본값을 강화하고 상태/구성을 chmod합니다.

플러그인

확장 및 해당 구성 관리:

  • mayros plugins list — 플러그인 검색 (기계 출력에는 --json 사용).
  • mayros plugins info <id> — 플러그인 세부 정보 표시.
  • mayros plugins install <path|.tgz|npm-spec> — 플러그인 설치 (또는 plugins.load.paths에 플러그인 경로 추가).
  • mayros plugins enable <id> / disable <id> — plugins.entries.<id>.enabled 토글.
  • mayros plugins doctor — 플러그인 로드 오류 보고.

대부분의 플러그인 변경 사항은 게이트웨이 재시작이 필요합니다. /plugin을 참조하세요.

메모리

MEMORY.md + memory/*.md에 대한 벡터 검색:

  • mayros memory status — 인덱스 통계 표시.
  • mayros memory index — 메모리 파일 재인덱싱.
  • mayros memory search "<query>" — 메모리에 대한 의미론적 검색.

채팅 슬래시 명령

채팅 메시지는 /... 명령 (텍스트 및 네이티브)을 지원합니다. /tools/slash-commands를 참조하세요.

하이라이트:

  • 빠른 진단을 위한 /status.
  • 지속된 구성 변경을 위한 /config.
  • 런타임 전용 구성 재정의를 위한 /debug (메모리, 디스크 아님; commands.debug: true 필요).

설정 + 온보딩

setup

구성 + 작업 공간을 초기화합니다.

옵션:

  • --workspace <dir>: 에이전트 작업 공간 경로 (기본값 ~/.mayros/workspace).
  • --wizard: 온보딩 마법사 실행.
  • --non-interactive: 프롬프트 없이 마법사 실행.
  • --mode <local|remote>: 마법사 모드.
  • --remote-url <url>: 원격 Gateway URL.
  • --remote-token <token>: 원격 Gateway 토큰.

마법사 플래그가 있으면 마법사가 자동 실행됩니다 (--non-interactive, --mode, --remote-url, --remote-token).

onboard

게이트웨이, 작업 공간 및 스킬을 설정하는 대화형 마법사.

옵션:

  • --workspace <dir>
  • --reset (마법사 전에 구성 + 자격 증명 + 세션 + 작업 공간 재설정)
  • --non-interactive
  • --mode <local|remote>
  • --flow <quickstart|advanced|manual> (manual은 advanced의 별칭)
  • --auth-choice <setup-token|token|chutes|openai-codex|openai-api-key|openrouter-api-key|ai-gateway-api-key|moonshot-api-key|moonshot-api-key-cn|kimi-code-api-key|synthetic-api-key|venice-api-key|gemini-api-key|zai-api-key|apiKey|minimax-api|minimax-api-lightning|opencode-zen|custom-api-key|skip>
  • --token-provider <id> (비대화형; --auth-choice token과 함께 사용)
  • --token <token> (비대화형; --auth-choice token과 함께 사용)
  • --token-profile-id <id> (비대화형; 기본값: <provider>:manual)
  • --token-expires-in <duration> (비대화형; 예: 365d, 12h)
  • --anthropic-api-key <key>
  • --openai-api-key <key>
  • --openrouter-api-key <key>
  • --ai-gateway-api-key <key>
  • --moonshot-api-key <key>
  • --kimi-code-api-key <key>
  • --gemini-api-key <key>
  • --zai-api-key <key>
  • --minimax-api-key <key>
  • --opencode-zen-api-key <key>
  • --custom-base-url <url> (비대화형; --auth-choice custom-api-key와 함께 사용)
  • --custom-model-id <id> (비대화형; --auth-choice custom-api-key와 함께 사용)
  • --custom-api-key <key> (비대화형; 선택 사항; --auth-choice custom-api-key와 함께 사용; 생략 시 CUSTOM_API_KEY로 폴백)
  • --custom-provider-id <id> (비대화형; 선택적 사용자 정의 공급자 ID)
  • --custom-compatibility <openai|anthropic> (비대화형; 선택 사항; 기본값 openai)
  • --gateway-port <port>
  • --gateway-bind <loopback|lan|tailnet|auto|custom>
  • --gateway-auth <token|password>
  • --gateway-token <token>
  • --gateway-password <password>
  • --remote-url <url>
  • --remote-token <token>
  • --tailscale <off|serve|funnel>
  • --tailscale-reset-on-exit
  • --install-daemon
  • --no-install-daemon (별칭: --skip-daemon)
  • --daemon-runtime <node|bun>
  • --skip-channels
  • --skip-skills
  • --skip-health
  • --skip-ui
  • --node-manager <npm|pnpm|bun> (pnpm 권장; Gateway 런타임에는 bun 권장하지 않음)
  • --json

configure

대화형 구성 마법사 (모델, 채널, 스킬, 게이트웨이).

config

비대화형 구성 헬퍼 (get/set/unset). 하위 명령 없이 mayros config를 실행하면 마법사가 시작됩니다.

하위 명령:

  • config get <path>: 구성 값 출력 (점/대괄호 경로).
  • config set <path> <value>: 값 설정 (JSON5 또는 원시 문자열).
  • config unset <path>: 값 제거.

doctor

상태 확인 + 빠른 수정 (구성 + 게이트웨이 + 레거시 서비스).

옵션:

  • --no-workspace-suggestions: 작업 공간 메모리 힌트 비활성화.
  • --yes: 프롬프트 없이 기본값 수락 (헤드리스).
  • --non-interactive: 프롬프트 건너뛰기; 안전한 마이그레이션만 적용.
  • --deep: 추가 게이트웨이 설치를 위한 시스템 서비스 스캔.

채널 헬퍼

channels

채팅 채널 계정 관리 (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (플러그인)/Signal/iMessage/MS Teams).

하위 명령:

  • channels list: 구성된 채널 및 인증 프로필 표시.
  • channels status: 게이트웨이 도달 가능성 및 채널 상태 확인 (--probe는 추가 확인 실행; 게이트웨이 상태 프로브에는 mayros health 또는 mayros status --deep 사용).
  • 팁: channels status는 일반적인 잘못된 구성을 감지할 수 있을 때 제안된 수정 사항과 함께 경고를 출력합니다 (그런 다음 mayros doctor를 가리킴).
  • channels logs: 게이트웨이 로그 파일에서 최근 채널 로그 표시.
  • channels add: 플래그가 전달되지 않으면 마법사 스타일 설정; 플래그는 비대화형 모드로 전환.
  • channels remove: 기본적으로 비활성화; 프롬프트 없이 구성 항목을 제거하려면 --delete 전달.
  • channels login: 대화형 채널 로그인 (WhatsApp Web만).
  • channels logout: 채널 세션에서 로그아웃 (지원되는 경우).

일반 옵션:

  • --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
  • --account <id>: 채널 계정 ID (기본값 default)
  • --name <label>: 계정 표시 이름

channels login 옵션:

  • --channel <channel> (기본값 whatsapp; whatsapp/web 지원)
  • --account <id>
  • --verbose

channels logout 옵션:

  • --channel <channel> (기본값 whatsapp)
  • --account <id>

channels list 옵션:

  • --no-usage: 모델 공급자 사용량/할당량 스냅샷 건너뛰기 (OAuth/API 지원만).
  • --json: JSON 출력 (--no-usage가 설정되지 않으면 사용량 포함).

channels logs 옵션:

  • --channel <name|all> (기본값 all)
  • --lines <n> (기본값 200)
  • --json

자세한 내용: /concepts/oauth

예시:

bash
mayros channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
mayros channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN
mayros channels remove --channel discord --account work --delete
mayros channels status --probe
mayros status --deep

skills

사용 가능한 스킬 및 준비 정보 목록 및 검사.

하위 명령:

  • skills list: 스킬 목록 (하위 명령 없을 때 기본값).
  • skills info <name>: 하나의 스킬에 대한 세부 정보 표시.
  • skills check: 준비된 것과 누락된 요구 사항의 요약.

옵션:

  • --eligible: 준비된 스킬만 표시.
  • --json: JSON 출력 (스타일링 없음).
  • -v, --verbose: 누락된 요구 사항 세부 정보 포함.

팁: mayros skills hub를 사용하여 스킬을 검색, 설치 및 동기화하세요.

pairing

채널 간 DM 페어링 요청 승인.

하위 명령:

  • pairing list <channel> [--json]
  • pairing approve <channel> <code> [--notify]

webhooks gmail

Gmail Pub/Sub 후크 설정 + 러너. /automation/gmail-pubsub를 참조하세요.

하위 명령:

  • webhooks gmail setup (--account <email> 필수; --project, --topic, --subscription, --label, --hook-url, --hook-token, --push-token, --bind, --port, --path, --include-body, --max-bytes, --renew-minutes, --tailscale, --tailscale-path, --tailscale-target, --push-endpoint, --json 지원)
  • webhooks gmail run (동일 플래그의 런타임 재정의)

dns setup

광역 검색 DNS 헬퍼 (CoreDNS + Tailscale). /gateway/discovery를 참조하세요.

옵션:

  • --apply: CoreDNS 구성 설치/업데이트 (sudo 필요; macOS만).

메시징 + 에이전트

message

통합 아웃바운드 메시징 + 채널 작업.

참조: /cli/message

하위 명령:

  • message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|ban
  • message thread <create|list|reply>
  • message emoji <list|upload>
  • message sticker <send|upload>
  • message role <info|add|remove>
  • message channel <info|list>
  • message member info
  • message voice status
  • message event <list|create>

예시:

  • mayros message send --target +15555550123 --message "Hi"
  • mayros message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi

agent

Gateway를 통해 하나의 에이전트 턴 실행 (또는 --local 임베디드).

필수:

  • --message <text>

옵션:

  • --to <dest> (세션 키 및 선택적 전달용)
  • --session-id <id>
  • --thinking <off|minimal|low|medium|high|xhigh> (GPT-5.2 + Codex 모델만)
  • --verbose <on|full|off>
  • --channel <whatsapp|telegram|discord|slack|mattermost|signal|imessage|msteams>
  • --local
  • --deliver
  • --json
  • --timeout <seconds>

agents

격리된 에이전트 관리 (작업 공간 + 인증 + 라우팅).

agents list

구성된 에이전트 목록.

옵션:

  • --json
  • --bindings

agents add [name]

새 격리된 에이전트 추가. 플래그 (또는 --non-interactive)가 전달되지 않으면 가이드 마법사를 실행합니다; 비대화형 모드에서는 --workspace가 필요합니다.

옵션:

  • --workspace <dir>
  • --model <id>
  • --agent-dir <dir>
  • --bind <channel[:accountId]> (반복 가능)
  • --non-interactive
  • --json

바인딩 사양은 channel[:accountId]를 사용합니다. WhatsApp에 대해 accountId가 생략되면 기본 계정 ID가 사용됩니다.

agents delete <id>

에이전트를 삭제하고 작업 공간 + 상태를 정리합니다.

옵션:

  • --force
  • --json

acp

IDE를 Gateway에 연결하는 ACP 브리지를 실행합니다.

전체 옵션 및 예시는 acp를 참조하세요.

status

연결된 세션 상태 및 최근 수신자를 표시합니다.

옵션:

  • --json
  • --all (전체 진단; 읽기 전용, 붙여넣기 가능)
  • --deep (채널 프로브)
  • --usage (모델 공급자 사용량/할당량 표시)
  • --timeout <ms>
  • --verbose
  • --debug (--verbose의 별칭)

참고:

  • 개요에는 사용 가능한 경우 Gateway + 노드 호스트 서비스 상태가 포함됩니다.

사용량 추적

Mayros는 OAuth/API 자격 증명이 있을 때 공급자 사용량/할당량을 표시할 수 있습니다.

표시 위치:

  • /status (사용 가능한 경우 짧은 공급자 사용량 줄 추가)
  • mayros status --usage (전체 공급자 분석 출력)
  • macOS 메뉴 바 (컨텍스트 아래 사용량 섹션)

참고:

  • 데이터는 공급자 사용량 엔드포인트에서 직접 가져옵니다 (추정 없음).
  • 공급자: Anthropic, GitHub Copilot, OpenAI Codex OAuth, 그리고 해당 공급자 플러그인이 활성화된 경우 Gemini CLI/Antigravity.
  • 일치하는 자격 증명이 없으면 사용량이 숨겨집니다.
  • 세부 정보: 사용량 추적 참조.

health

실행 중인 Gateway에서 상태를 가져옵니다.

옵션:

  • --json
  • --timeout <ms>
  • --verbose

sessions

저장된 대화 세션 목록.

옵션:

  • --json
  • --verbose
  • --store <path>
  • --active <minutes>

재설정 / 제거

reset

로컬 구성/상태 재설정 (CLI는 설치된 상태로 유지).

옵션:

  • --scope <config|config+creds+sessions|full>
  • --yes
  • --non-interactive
  • --dry-run

참고:

  • --non-interactive에는 --scope와 --yes가 필요합니다.

uninstall

게이트웨이 서비스 + 로컬 데이터 제거 (CLI는 유지).

옵션:

  • --service
  • --state
  • --workspace
  • --app
  • --all
  • --yes
  • --non-interactive
  • --dry-run

참고:

  • --non-interactive에는 --yes와 명시적 범위 (또는 --all)가 필요합니다.

Gateway

gateway

WebSocket Gateway를 실행합니다.

옵션:

  • --port <port>
  • --bind <loopback|tailnet|lan|auto|custom>
  • --token <token>
  • --auth <token|password>
  • --password <password>
  • --tailscale <off|serve|funnel>
  • --tailscale-reset-on-exit
  • --allow-unconfigured
  • --dev
  • --reset (개발 구성 + 자격 증명 + 세션 + 작업 공간 재설정)
  • --force (포트의 기존 리스너 종료)
  • --verbose
  • --claude-cli-logs
  • --ws-log <auto|full|compact>
  • --compact (--ws-log compact의 별칭)
  • --raw-stream
  • --raw-stream-path <path>

Gateway 서비스

Gateway 서비스 관리 (launchd/systemd/schtasks).

하위 명령:

  • gateway status (기본적으로 Gateway RPC를 프로브)
  • gateway install (서비스 설치)
  • gateway uninstall
  • gateway start
  • gateway stop
  • gateway restart

참고:

  • gateway status는 서비스의 해결된 포트/구성을 사용하여 기본적으로 Gateway RPC를 프로브합니다 (--url/--token/--password로 재정의).
  • gateway status는 스크립팅을 위해 --no-probe, --deep, --json을 지원합니다.
  • gateway status는 감지할 수 있는 레거시 또는 추가 게이트웨이 서비스도 표시합니다 (--deep은 시스템 수준 스캔 추가). 프로필 이름의 Mayros 서비스는 일급으로 취급되며 "추가"로 표시되지 않습니다.
  • gateway status는 CLI가 사용하는 구성 경로와 서비스가 사용할 가능성이 높은 구성 (서비스 env), 해결된 프로브 대상 URL을 출력합니다.
  • gateway install|uninstall|start|stop|restart는 스크립팅을 위해 --json을 지원합니다 (기본 출력은 사람 친화적).
  • gateway install은 기본적으로 Node 런타임을 사용합니다; bun은 권장하지 않음 (WhatsApp/Telegram 버그).
  • gateway install 옵션: --port, --runtime, --token, --force, --json.

logs

RPC를 통해 Gateway 파일 로그를 tail합니다.

참고:

  • TTY 세션은 색상이 지정된 구조화된 뷰를 렌더링합니다; 비TTY는 일반 텍스트로 폴백합니다.
  • --json은 줄로 구분된 JSON을 내보냅니다 (로그 이벤트당 한 줄).

예시:

bash
mayros logs --follow
mayros logs --limit 200
mayros logs --plain
mayros logs --json
mayros logs --no-color

gateway <subcommand>

Gateway CLI 헬퍼 (RPC 하위 명령에는 --url, --token, --password, --timeout, --expect-final 사용). --url을 전달하면 CLI가 구성이나 환경 자격 증명을 자동 적용하지 않습니다. --token 또는 --password를 명시적으로 포함하세요. 명시적 자격 증명이 없으면 오류입니다.

하위 명령:

  • gateway call <method> [--params <json>]
  • gateway health
  • gateway status
  • gateway probe
  • gateway discover
  • gateway install|uninstall|start|stop|restart
  • gateway run

일반 RPC:

  • config.apply (구성 검증 + 쓰기 + 재시작 + 깨우기)
  • config.patch (부분 업데이트 병합 + 재시작 + 깨우기)
  • update.run (업데이트 실행 + 재시작 + 깨우기)

팁: config.set/config.apply/config.patch를 직접 호출할 때, 구성이 이미 존재하면 config.get의 baseHash를 전달하세요.

모델

폴백 동작 및 스캔 전략은 /concepts/models를 참조하세요.

선호하는 Anthropic 인증 (setup-token):

bash
claude setup-token
mayros models auth setup-token --provider anthropic
mayros models status

models (루트)

mayros models는 models status의 별칭입니다.

루트 옵션:

  • --status-json (models status --json의 별칭)
  • --status-plain (models status --plain의 별칭)

models list

옵션:

  • --all
  • --local
  • --provider <name>
  • --json
  • --plain

models status

옵션:

  • --json
  • --plain
  • --check (종료 1=만료/누락, 2=만료 임박)
  • --probe (구성된 인증 프로필의 라이브 프로브)
  • --probe-provider <name>
  • --probe-profile <id> (반복 또는 쉼표 구분)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>

항상 인증 개요 및 인증 저장소의 프로필에 대한 OAuth 만료 상태를 포함합니다. --probe는 라이브 요청을 실행합니다 (토큰을 소비하고 속도 제한을 트리거할 수 있습니다).

models set <model>

agents.defaults.model.primary를 설정합니다.

models set-image <model>

agents.defaults.imageModel.primary를 설정합니다.

models aliases list|add|remove

옵션:

  • list: --json, --plain
  • add <alias> <model>
  • remove <alias>

models fallbacks list|add|remove|clear

옵션:

  • list: --json, --plain
  • add <model>
  • remove <model>
  • clear

models image-fallbacks list|add|remove|clear

옵션:

  • list: --json, --plain
  • add <model>
  • remove <model>
  • clear

models scan

옵션:

  • --min-params <b>
  • --max-age-days <days>
  • --provider <name>
  • --max-candidates <n>
  • --timeout <ms>
  • --concurrency <n>
  • --no-probe
  • --yes
  • --no-input
  • --set-default
  • --set-image
  • --json

models auth add|setup-token|paste-token

옵션:

  • add: 대화형 인증 헬퍼
  • setup-token: --provider <name> (기본값 anthropic), --yes
  • paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

models auth order get|set|clear

옵션:

  • get: --provider <name>, --agent <id>, --json
  • set: --provider <name>, --agent <id>, <profileIds...>
  • clear: --provider <name>, --agent <id>

시스템

system event

시스템 이벤트를 큐에 넣고 선택적으로 하트비트를 트리거합니다 (Gateway RPC).

필수:

  • --text <text>

옵션:

  • --mode <now|next-heartbeat>
  • --json
  • --url, --token, --timeout, --expect-final

system heartbeat last|enable|disable

하트비트 제어 (Gateway RPC).

옵션:

  • --json
  • --url, --token, --timeout, --expect-final

system presence

시스템 프레즌스 항목 목록 (Gateway RPC).

옵션:

  • --json
  • --url, --token, --timeout, --expect-final

Cron

예약된 작업 관리 (Gateway RPC). /automation/cron-jobs를 참조하세요.

하위 명령:

  • cron status [--json]
  • cron list [--all] [--json] (기본값 테이블 출력; raw에는 --json 사용)
  • cron add (별칭: create; --name과 --at | --every | --cron 중 하나, 그리고 --system-event | --message 중 하나의 페이로드 필요)
  • cron edit <id> (필드 패치)
  • cron rm <id> (별칭: remove, delete)
  • cron enable <id>
  • cron disable <id>
  • cron runs --id <id> [--limit <n>]
  • cron run <id> [--force]

모든 cron 명령은 --url, --token, --timeout, --expect-final을 수락합니다.

노드 호스트

node는 헤드리스 노드 호스트를 실행하거나 백그라운드 서비스로 관리합니다. mayros node를 참조하세요.

하위 명령:

  • node run --host <gateway-host> --port 18789
  • node status
  • node install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]
  • node uninstall
  • node stop
  • node restart

노드

nodes는 Gateway와 통신하고 페어링된 노드를 대상으로 합니다. /nodes를 참조하세요.

일반 옵션:

  • --url, --token, --timeout, --json

하위 명령:

  • nodes status [--connected] [--last-connected <duration>]
  • nodes describe --node <id|name|ip>
  • nodes list [--connected] [--last-connected <duration>]
  • nodes pending
  • nodes approve <requestId>
  • nodes reject <requestId>
  • nodes rename --node <id|name|ip> --name <displayName>
  • nodes invoke --node <id|name|ip> --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]
  • nodes run --node <id|name|ip> [--cwd <path>] [--env KEY=VAL] [--command-timeout <ms>] [--needs-screen-recording] [--invoke-timeout <ms>] <command...> (mac 노드 또는 헤드리스 노드 호스트)
  • nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (mac만)

카메라:

  • nodes camera list --node <id|name|ip>
  • nodes camera snap --node <id|name|ip> [--facing front|back|both] [--device-id <id>] [--max-width <px>] [--quality <0-1>] [--delay-ms <ms>] [--invoke-timeout <ms>]
  • nodes camera clip --node <id|name|ip> [--facing front|back] [--device-id <id>] [--duration <ms|10s|1m>] [--no-audio] [--invoke-timeout <ms>]

캔버스 + 화면:

  • nodes canvas snapshot --node <id|name|ip> [--format png|jpg|jpeg] [--max-width <px>] [--quality <0-1>] [--invoke-timeout <ms>]
  • nodes canvas present --node <id|name|ip> [--target <urlOrPath>] [--x <px>] [--y <px>] [--width <px>] [--height <px>] [--invoke-timeout <ms>]
  • nodes canvas hide --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes canvas navigate <url> --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes canvas eval [<js>] --node <id|name|ip> [--js <code>] [--invoke-timeout <ms>]
  • nodes canvas a2ui push --node <id|name|ip> (--jsonl <path> | --text <text>) [--invoke-timeout <ms>]
  • nodes canvas a2ui reset --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes screen record --node <id|name|ip> [--screen <index>] [--duration <ms|10s>] [--fps <n>] [--no-audio] [--out <path>] [--invoke-timeout <ms>]

위치:

  • nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]

브라우저

브라우저 제어 CLI (전용 Chrome/Brave/Edge/Chromium). mayros browser 및 브라우저 도구를 참조하세요.

일반 옵션:

  • --url, --token, --timeout, --json
  • --browser-profile <name>

관리:

  • browser status
  • browser start
  • browser stop
  • browser reset-profile
  • browser tabs
  • browser open <url>
  • browser focus <targetId>
  • browser close [targetId]
  • browser profiles
  • browser create-profile --name <name> [--color <hex>] [--cdp-url <url>]
  • browser delete-profile --name <name>

검사:

  • browser screenshot [targetId] [--full-page] [--ref <ref>] [--element <selector>] [--type png|jpeg]
  • browser snapshot [--format aria|ai] [--target-id <id>] [--limit <n>] [--interactive] [--compact] [--depth <n>] [--selector <sel>] [--out <path>]

작업:

  • browser navigate <url> [--target-id <id>]
  • browser resize <width> <height> [--target-id <id>]
  • browser click <ref> [--double] [--button <left|right|middle>] [--modifiers <csv>] [--target-id <id>]
  • browser type <ref> <text> [--submit] [--slowly] [--target-id <id>]
  • browser press <key> [--target-id <id>]
  • browser hover <ref> [--target-id <id>]
  • browser drag <startRef> <endRef> [--target-id <id>]
  • browser select <ref> <values...> [--target-id <id>]
  • browser upload <paths...> [--ref <ref>] [--input-ref <ref>] [--element <selector>] [--target-id <id>] [--timeout-ms <ms>]
  • browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]
  • browser dialog --accept|--dismiss [--prompt <text>] [--target-id <id>] [--timeout-ms <ms>]
  • browser wait [--time <ms>] [--text <value>] [--text-gone <value>] [--target-id <id>]
  • browser evaluate --fn <code> [--ref <ref>] [--target-id <id>]
  • browser console [--level <error|warn|info>] [--target-id <id>]
  • browser pdf [--target-id <id>]

문서 검색

docs [query...]

라이브 문서 인덱스를 검색합니다.

TUI

tui

Gateway에 연결된 터미널 UI를 엽니다.

옵션:

  • --url <url>
  • --token <token>
  • --password <password>
  • --session <key>
  • --deliver
  • --thinking <level>
  • --message <text>
  • --timeout-ms <ms> (기본값은 agents.defaults.timeoutSeconds)
  • --history-limit <n>