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