跳转到正文
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. Shell 工具
  20. Shell 函数
  21. TUIs
  22. 图形界面
  23. 浏览器
  24. 商业应用/服务
  25. 网页应用
  26. 游戏
  27. 填写 PDF
  28. Windows 虚拟机
  29. 其他软件包
  30. 更新
  31. Dotfiles
  32. Shell 插件
  33. 显示器
  34. 键盘、鼠标、触控板
  35. 网络
  36. 系统睡眠
  37. 硬件身份验证
  38. 字体
  39. 背景
  40. 提示符
  41. 品牌定制
  42. 常见调整
  43. 制作你自己的主题
  44. Mac 支持
  45. 故障排除
  46. FAQ
  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 会把它收起来。