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

每条命令都接受 --help，无论你请求的是整个分组（omarchy capture --help）还是单条命令（omarchy capture screenshot --help）。

从终端打开菜单 #

Omarchy 菜单也支持脚本化，这对配置自己的快捷键很方便。omarchy menu 会在根级打开菜单；通过指定树中的路径，可以直接跳转到任意位置：omarchy menu summon style.theme 会直接进入主题选择器，omarchy menu toggle system 会打开系统菜单，如果系统菜单已经打开则将其关闭，而 omarchy menu close 会将菜单收起。