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 则直接关闭菜单。