본문으로 건너뛰기
Chapters
  1. Omarchy에 오신 것을 환영합니다!
  2. 시작하기
  3. Mac이나 Windows에서 오신 분들
  4. 탐색
  5. 상단 바
  6. 테마
  7. 단축키
  8. 통합 클립보드 및 기록
  9. 리마인더
  10. 알림
  11. 텍스트 추출 및 받아쓰기
  12. 스크린샷 및 녹화
  13. 토글, 유휴 상태 & 화면 보호기
  14. Omarchy CLI
  15. 터미널
  16. Neovim
  17. AI
  18. 개발 도구
  19. 셸 도구
  20. 셸 함수
  21. TUIs
  22. GUI
  23. 브라우저
  24. 상용 앱/서비스
  25. 웹 앱
  26. 게이밍
  27. PDF 작성하기
  28. Windows VM
  29. 기타 패키지
  30. 업데이트
  31. Dotfiles
  32. 셸 플러그인
  33. 모니터
  34. 키보드, 마우스, 트랙패드
  35. 네트워킹
  36. 시스템 절전
  37. 하드웨어 인증
  38. 글꼴
  39. 배경
  40. 프롬프트
  41. 브랜딩
  42. 흔한 조정
  43. 나만의 테마 만들기
  44. Mac 지원
  45. 문제 해결
  46. 자주 묻는 질문
  47. 시스템 스냅샷
  48. 보안
  49. Omarchy를 ...에서
  50. 듀얼 부팅 설치
  51. 무인 설치

매뉴얼

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 agents, their usage, and subscription accounts
  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|scroll] [copy|save]                                                                                                                                          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

모든 명령어에도 --help를 사용할 수 있습니다. 그룹 전체에 대해 묻든(omarchy capture --help) 단일 명령어에 대해 묻든(omarchy capture screenshot --help) 마찬가지입니다.

터미널에서 메뉴 열기

Omarchy 메뉴도 스크립트로 제어할 수 있어, 직접 만든 키 바인딩에 활용하기 편리합니다. omarchy menu는 메뉴를 루트에서 열고, 이름을 지정하면 트리의 원하는 지점으로 바로 이동할 수 있습니다: omarchy menu summon appearance.theme는 테마 선택 화면으로 바로 이동하고, omarchy menu toggle system은 시스템 메뉴를 열며 이미 열려 있으면 다시 닫고, omarchy menu close는 메뉴를 닫습니다.