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

메시징 + 에이전트

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>

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>

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

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>