Omarchy CLI 명령어 도구

Omarchy는 일반적으로 단축키와 Omarchy 메뉴(Super + Space)를 통해 제어합니다. 하지만 omarchy CLI를 사용하여 명령줄에서 모든 기능을 조작할 수도 있습니다. AI 코딩 Agent와 협업하여 시스템 환경을 커스터마이징하거나 설정을 변경할 때 특히 강력합니다.

CLI는 메뉴 및 시스템 전반에서 사용되는 모든 내부 도구 체계에 접근할 수 있습니다. 터미널에서 omarchy를 실행하면 사용 가능한 모든 기능을 확인할 수 있습니다.

출력 예시는 다음과 같습니다:

~ ❯ omarchy
Omarchy command center

Usage:
  omarchy <command> [args...]
  omarchy commands [--all] [--json] [--check]
  omarchy <group> --help
  omarchy <group> <command> --help

Common commands:
  omarchy update              Update Omarchy and system packages
  omarchy theme list          List available themes
  omarchy theme set <name>    Apply a theme
  omarchy font list           List available fonts
  omarchy screenshot          Take a screenshot
  omarchy debug               Print debugging information

Groups:
  agent          AI coding agent usage data
  audio          Audio input and output controls
  bar            Omarchy shell bar layout and settings
  battery        Battery status helpers
  bluetooth      Bluetooth device controls
  branch         Omarchy git branch management
  branding       About and screensaver branding
  brightness     Display and keyboard brightness
  capture        Screenshots and screen recording
  channel        Omarchy release channel management
  clipboard      Clipboard helpers
  cmd            Command and shortcut helpers
  config         System configuration helpers
  debug          Diagnostics and support logs
  ...

각 명령어 그룹별로 더 깊이 있는 하위 도움말을 살펴볼 수도 있습니다:

~ ❯ omarchy capture
Capture commands — Screenshots and screen recording:
  omarchy capture qr                                                                                                                                                                                                       Decode a QR code from a screenshot region
  omarchy capture screenrecording [--fullscreen] [--with-desktop-audio] [--with-microphone-audio] [--with-webcam] [--webcam-device=<device>] [--webcam-size=<small|medium|large>] [--resolution=<size>] [--stop-recording]  Start or stop screen recording
  omarchy capture screenrecording with webcam                                                                                                                                                                              Pick a webcam and start a screen recording with it
  omarchy capture screenshot [smart|region|windows|fullscreen] [slurp|copy|save] [--editor=<name>]                                                                                                                         Take a screenshot
  omarchy capture text                                                                                                                                                                                                     Extract text from a screenshot region with OCR
  omarchy capture webcam resize <smaller|larger|reset|small|medium|large>                                                                                                                                                  Resize the active webcam recording overlay

모든 명령어는 그룹 전체(omarchy capture --help)나 개별 명령어(omarchy capture screenshot --help) 모두 --help 플래그를 완벽히 지원합니다.

터미널에서 메뉴 제어하기

Omarchy 메뉴는 스크립트 제어를 지원하므로 사용자 정의 단축키를 만들 때 유용합니다. omarchy menu는 루트에서 메뉴를 열며, 경로 이름을 지정하여 메뉴 트리의 특정 지점으로 즉시 이동할 수도 있습니다: omarchy menu summon style.theme는 테마 선택기를 바로 열고, omarchy menu toggle system은 시스템 메뉴를 토글하며, omarchy menu close는 메뉴를 닫습니다.