omarchy
Omarchy operating guardrails for day-to-day system work: assume the host is Omarchy by default, choose Omarchy-native workflows first, map user intent to the correct omarchy-* wrapper/script family, and avoid generic Linux commands that conflict with Omarchy behavior. Use whenever handling local system tasks on this host unless the user explicitly says it is not Omarchy; prioritize safe Omarchy commands, prevent non-Omarchy shortcuts (e.g., ad-hoc process killing/relaunch patterns), troubleshoot desktop behavior, and validate the right script before execution.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- omarchy
- description
- Omarchy operating guardrails for day-to-day system work: assume the host is Omarchy by default, choose Omarchy-native workflows first, map user intent to the correct omarchy-* wrapper/script family, and avoid generic Linux commands that conflict with Omarchy behavior. Use whenever handling local system tasks on this host unless the user explicitly says it is not Omarchy; prioritize safe Omarchy commands, prevent non-Omarchy shortcuts (e.g., ad-hoc process killing/relaunch patterns), troubleshoot desktop behavior, and validate the right script before execution.
03 SKILL.md 正文
Omarchy Skill
Treat this skill as an Omarchy operating mode, not just a command catalog. When working on an Omarchy system, prefer Omarchy-native wrappers and workflows over generic Linux one-liners that may bypass expected state handling. Use local script docs and names to choose the correct path. Each script has documentation at the top describing its purpose. DO NOT RUN A SCRIPT UNTIL YOU ARE SURE OF ITS PURPOSE.
Operating rules
- Start with command name matching and in-file comments under
/home/achals/.local/share/omarchy/bin. - Prefer read-only/status commands first (
*list*,*status*,*current*,*available*,*version*). - Ask before broad or high-impact actions (
*install*,*remove*,*reinstall*,*update*,*pkg*,*setup*,*set*). - Avoid bulk discovery execution. Do static inspection first.
- Never assume
omarchy-*scripts support standard CLI flags or parameters (including--help). Treat each script as custom; inspect its file/header comments first.
Worked examples (good vs bad)
Use these patterns whenever you operate on Omarchy. The goal is not "run an omarchy command at all costs"; the goal is to avoid bypassing Omarchy’s intended state-management flows.
1) Restarting Waybar
User intent: "Waybar is broken, restart it."
- Bad (generic shortcut):
pkill waybar && waybar
- Good (Omarchy-native):
omarchy-restart-waybar
- Why: Omarchy wrappers usually handle environment/session assumptions better than raw kill-and-relaunch one-liners.
2) Applying config/UI refresh after edits
User intent: "I changed config, apply it."
- Bad:
- restarting random processes manually until things look fixed
- Good:
- use targeted refresh script first, e.g.
omarchy-refresh-waybar,omarchy-refresh-hyprland,omarchy-refresh-config(pick by component)
- use targeted refresh script first, e.g.
- Why: refresh scripts are explicit and reversible; manual shotgun restarts are noisy and risky.
3) Package management task
User intent: "Install/remove package X."
- Bad:
- using raw
pacman/yayfirst without checking Omarchy wrappers
- using raw
- Good:
- inspect and prefer
omarchy-pkg-*flow (...-present,...-missing, then...-install/...-remove)
- inspect and prefer
- Why: wrapper flow keeps behavior consistent with Omarchy expectations.
4) Theme change request
User intent: "Switch theme / sync theme to apps."
- Bad:
- editing dotfiles manually first and restarting random apps
- Good:
omarchy-theme-list->omarchy-theme-set-> app-specific follow-ups if needed (omarchy-theme-set-vscode,...-browser,...-obsidian)
- Why: Omarchy theme pipeline may include extra integration steps beyond plain config edits.
5) Audio/Bluetooth/Wi‑Fi issue
User intent: "Audio/Bluetooth/Wi‑Fi stopped behaving."
- Bad:
- broad process killing (
killall pipewire, random daemon restarts)
- broad process killing (
- Good:
- use targeted wrapper restarts such as
omarchy-restart-pipewire,omarchy-restart-bluetooth,omarchy-restart-wifi
- use targeted wrapper restarts such as
- Why: targeted wrappers reduce collateral damage and match Omarchy’s service model.
6) "What command should I run?" discovery flow
User intent: ambiguous request like "fix my display stack".
- Bad:
- execute many commands to discover options (
for c in omarchy-*; do $c --help; done)
- execute many commands to discover options (
- Good:
- Statically inspect names in
/home/achals/.local/share/omarchy/bin - Read top-of-file script comments for likely candidates
- Start with read-only/status scripts
- Propose 1-3 likely commands and ask before high-impact actions
- Statically inspect names in
- Why: static inspection is safer, faster, and follows no-bulk-probing policy.
7) Update workflow
User intent: "Update system."
- Bad:
- directly running full update steps without checking availability/state
- Good:
- check first:
omarchy-update-available(and related status) - then execute appropriate Omarchy update path with confirmation for impactful steps
- check first:
- Why: staged update flow reduces surprise breakage.
Decision template (apply every time)
For any Omarchy task, follow this mini-checklist:
- Identify component (UI, package, theme, network, update, device, etc.)
- Find matching
omarchy-*family by name and script header comments - Prefer read-only/status command first
- Use targeted
omarchy-refresh-*/omarchy-restart-*over raw kill/relaunch - Ask before high-impact actions (
install/remove/reinstall/update/setup/set)
Omarchy command catalog (static, local)
Total commands: 161
battery (2)
omarchy-battery-monitoromarchy-battery-remaining
branch (1)
omarchy-branch-set
channel (1)
omarchy-channel-set
cmd (12)
omarchy-cmd-apple-display-brightnessomarchy-cmd-audio-switchomarchy-cmd-first-runomarchy-cmd-missingomarchy-cmd-presentomarchy-cmd-rebootomarchy-cmd-screenrecordomarchy-cmd-screensaveromarchy-cmd-screenshotomarchy-cmd-shareomarchy-cmd-shutdownomarchy-cmd-terminal-cwd
debug (1)
omarchy-debug
dev (1)
omarchy-dev-add-migration
drive (3)
omarchy-drive-infoomarchy-drive-selectomarchy-drive-set-password
font (3)
omarchy-font-currentomarchy-font-listomarchy-font-set
hibernation (3)
omarchy-hibernation-availableomarchy-hibernation-removeomarchy-hibernation-setup
hook (1)
omarchy-hook
hyprland (3)
omarchy-hyprland-window-close-allomarchy-hyprland-window-popomarchy-hyprland-workspace-toggle-gaps
install (9)
omarchy-install-chromium-google-accountomarchy-install-dev-envomarchy-install-docker-dbsomarchy-install-dropboxomarchy-install-steamomarchy-install-tailscaleomarchy-install-terminalomarchy-install-vscodeomarchy-install-xbox-controllers
launch (14)
omarchy-launch-aboutomarchy-launch-audioomarchy-launch-bluetoothomarchy-launch-browseromarchy-launch-editoromarchy-launch-floating-terminal-with-presentationomarchy-launch-or-focusomarchy-launch-or-focus-tuiomarchy-launch-or-focus-webappomarchy-launch-screensaveromarchy-launch-tuiomarchy-launch-walkeromarchy-launch-webappomarchy-launch-wifi
lock (1)
omarchy-lock-screen
menu (2)
omarchy-menuomarchy-menu-keybindings
migrate (1)
omarchy-migrate
notification (1)
omarchy-notification-dismiss
pkg (9)
omarchy-pkg-addomarchy-pkg-aur-accessibleomarchy-pkg-aur-addomarchy-pkg-aur-installomarchy-pkg-dropomarchy-pkg-installomarchy-pkg-missingomarchy-pkg-presentomarchy-pkg-remove
powerprofiles (1)
omarchy-powerprofiles-list
refresh (14)
omarchy-refresh-applicationsomarchy-refresh-chromiumomarchy-refresh-configomarchy-refresh-fastfetchomarchy-refresh-hypridleomarchy-refresh-hyprlandomarchy-refresh-hyprlockomarchy-refresh-hyprsunsetomarchy-refresh-limineomarchy-refresh-pacmanomarchy-refresh-plymouthomarchy-refresh-swayosdomarchy-refresh-walkeromarchy-refresh-waybar
reinstall (4)
omarchy-reinstallomarchy-reinstall-configsomarchy-reinstall-gitomarchy-reinstall-pkgs
remove (1)
omarchy-remove-dev-env
reset (1)
omarchy-reset-sudo
restart (15)
omarchy-restart-appomarchy-restart-bluetoothomarchy-restart-btopomarchy-restart-hyprctlomarchy-restart-hypridleomarchy-restart-hyprsunsetomarchy-restart-makoomarchy-restart-opencodeomarchy-restart-pipewireomarchy-restart-swayosdomarchy-restart-terminalomarchy-restart-walkeromarchy-restart-waybaromarchy-restart-wifiomarchy-restart-xcompose
setup (3)
omarchy-setup-dnsomarchy-setup-fido2omarchy-setup-fingerprint
show (2)
omarchy-show-doneomarchy-show-logo
snapshot (1)
omarchy-snapshot
state (1)
omarchy-state
theme (13)
omarchy-theme-bg-installomarchy-theme-bg-nextomarchy-theme-currentomarchy-theme-installomarchy-theme-listomarchy-theme-removeomarchy-theme-setomarchy-theme-set-browseromarchy-theme-set-gnomeomarchy-theme-set-obsidianomarchy-theme-set-templatesomarchy-theme-set-vscodeomarchy-theme-update
toggle (5)
omarchy-toggle-idleomarchy-toggle-nightlightomarchy-toggle-screensaveromarchy-toggle-suspendomarchy-toggle-waybar
tui (2)
omarchy-tui-installomarchy-tui-remove
tz (1)
omarchy-tz-select
update (14)
omarchy-updateomarchy-update-analyze-logsomarchy-update-availableomarchy-update-available-resetomarchy-update-branchomarchy-update-confirmomarchy-update-firmwareomarchy-update-gitomarchy-update-keyringomarchy-update-performomarchy-update-restartomarchy-update-system-pkgsomarchy-update-timeomarchy-update-without-idle
upload (1)
omarchy-upload-log
version (4)
omarchy-versionomarchy-version-branchomarchy-version-channelomarchy-version-pkgs
voxtype (5)
omarchy-voxtype-configomarchy-voxtype-installomarchy-voxtype-modelomarchy-voxtype-removeomarchy-voxtype-status
webapp (4)
omarchy-webapp-handler-heyomarchy-webapp-handler-zoomomarchy-webapp-installomarchy-webapp-remove
windows (1)
omarchy-windows-vm
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.