Omarchy LogoOMARCHYPULSE

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 でメニューを閉じます。