How should omarchy be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

Agent DossierCLAWHUBSafety 84/100

Xpersona Agent

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. --- 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 saf

OpenClaw · self-declared

Trust evidence available

View on ClawHub

clawhub skill install skills:achals-iglu:omarchy

Overall rank

#62

Adoption

No public adoption signal

Trust

Unknown

Freshness

Feb 25, 2026

Freshness

Last checked Feb 25, 2026

Best For

omarchy is best for standard workflows where OpenClaw compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, CLAWHUB, runtime-metrics, public facts pack

Overview Evidence & Timeline Artifacts & Docs API & Reliability Media & Related Machine Appendix

Overview

Key links, install path, reliability highlights, and the shortest practical read before diving into the crawl record.

Verifiededitorial-content

Overview

Executive Summary

No verified compatibility signals

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Feb 25, 2026

Vendor

Openclaw

Artifacts

Benchmarks

Last release

Unpublished

Install & run

Setup Snapshot

clawhub skill install skills:achals-iglu:omarchy

1
Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence & Timeline

Public facts grouped by evidence type, plus release and crawl events with provenance and freshness.

Verifiededitorial-content

Public facts

Evidence Ledger

Vendor (1)

Vendor

Openclaw

profilemedium

Observed Apr 15, 2026Source link Provenance

Compatibility (1)

Protocol compatibility

OpenClaw

contractmedium

Observed Apr 15, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Events

Release & Crawl Timeline

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts & Docs

Parameters, dependencies, examples, extracted files, editorial overview, and the complete README when available.

Self-declaredCLAWHUB

Captured outputs

Artifacts Archive

Extracted files

Examples

Snippets

Languages

typescript

Parameters

Editorial read

Docs & README

Docs source

CLAWHUB

Editorial quality

ready

Full README

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."

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)
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/yay first without checking Omarchy wrappers
Good:
- inspect and prefer omarchy-pkg-* flow (...-present, ...-missing, then ...-install/...-remove)
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)
Good:
- use targeted wrapper restarts such as omarchy-restart-pipewire, omarchy-restart-bluetooth, omarchy-restart-wifi
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)
Good:
1. Statically inspect names in /home/achals/.local/share/omarchy/bin
2. Read top-of-file script comments for likely candidates
3. Start with read-only/status scripts
4. Propose 1-3 likely commands and ask before high-impact actions
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
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-monitor
omarchy-battery-remaining

branch (1)

omarchy-branch-set

channel (1)

omarchy-channel-set

cmd (12)

omarchy-cmd-apple-display-brightness
omarchy-cmd-audio-switch
omarchy-cmd-first-run
omarchy-cmd-missing
omarchy-cmd-present
omarchy-cmd-reboot
omarchy-cmd-screenrecord
omarchy-cmd-screensaver
omarchy-cmd-screenshot
omarchy-cmd-share
omarchy-cmd-shutdown
omarchy-cmd-terminal-cwd

debug (1)

omarchy-debug

dev (1)

omarchy-dev-add-migration

drive (3)

omarchy-drive-info
omarchy-drive-select
omarchy-drive-set-password

font (3)

omarchy-font-current
omarchy-font-list
omarchy-font-set

hibernation (3)

omarchy-hibernation-available
omarchy-hibernation-remove
omarchy-hibernation-setup

hook (1)

omarchy-hook

hyprland (3)

omarchy-hyprland-window-close-all
omarchy-hyprland-window-pop
omarchy-hyprland-workspace-toggle-gaps

install (9)

omarchy-install-chromium-google-account
omarchy-install-dev-env
omarchy-install-docker-dbs
omarchy-install-dropbox
omarchy-install-steam
omarchy-install-tailscale
omarchy-install-terminal
omarchy-install-vscode
omarchy-install-xbox-controllers

launch (14)

omarchy-launch-about
omarchy-launch-audio
omarchy-launch-bluetooth
omarchy-launch-browser
omarchy-launch-editor
omarchy-launch-floating-terminal-with-presentation
omarchy-launch-or-focus
omarchy-launch-or-focus-tui
omarchy-launch-or-focus-webapp
omarchy-launch-screensaver
omarchy-launch-tui
omarchy-launch-walker
omarchy-launch-webapp
omarchy-launch-wifi

lock (1)

omarchy-lock-screen

menu (2)

omarchy-menu
omarchy-menu-keybindings

migrate (1)

omarchy-migrate

notification (1)

omarchy-notification-dismiss

pkg (9)

omarchy-pkg-add
omarchy-pkg-aur-accessible
omarchy-pkg-aur-add
omarchy-pkg-aur-install
omarchy-pkg-drop
omarchy-pkg-install
omarchy-pkg-missing
omarchy-pkg-present
omarchy-pkg-remove

powerprofiles (1)

omarchy-powerprofiles-list

refresh (14)

omarchy-refresh-applications
omarchy-refresh-chromium
omarchy-refresh-config
omarchy-refresh-fastfetch
omarchy-refresh-hypridle
omarchy-refresh-hyprland
omarchy-refresh-hyprlock
omarchy-refresh-hyprsunset
omarchy-refresh-limine
omarchy-refresh-pacman
omarchy-refresh-plymouth
omarchy-refresh-swayosd
omarchy-refresh-walker
omarchy-refresh-waybar

reinstall (4)

omarchy-reinstall
omarchy-reinstall-configs
omarchy-reinstall-git
omarchy-reinstall-pkgs

remove (1)

omarchy-remove-dev-env

reset (1)

omarchy-reset-sudo

restart (15)

omarchy-restart-app
omarchy-restart-bluetooth
omarchy-restart-btop
omarchy-restart-hyprctl
omarchy-restart-hypridle
omarchy-restart-hyprsunset
omarchy-restart-mako
omarchy-restart-opencode
omarchy-restart-pipewire
omarchy-restart-swayosd
omarchy-restart-terminal
omarchy-restart-walker
omarchy-restart-waybar
omarchy-restart-wifi
omarchy-restart-xcompose

setup (3)

omarchy-setup-dns
omarchy-setup-fido2
omarchy-setup-fingerprint

show (2)

omarchy-show-done
omarchy-show-logo

snapshot (1)

omarchy-snapshot

state (1)

omarchy-state

theme (13)

omarchy-theme-bg-install
omarchy-theme-bg-next
omarchy-theme-current
omarchy-theme-install
omarchy-theme-list
omarchy-theme-remove
omarchy-theme-set
omarchy-theme-set-browser
omarchy-theme-set-gnome
omarchy-theme-set-obsidian
omarchy-theme-set-templates
omarchy-theme-set-vscode
omarchy-theme-update

toggle (5)

omarchy-toggle-idle
omarchy-toggle-nightlight
omarchy-toggle-screensaver
omarchy-toggle-suspend
omarchy-toggle-waybar

tui (2)

omarchy-tui-install
omarchy-tui-remove

tz (1)

omarchy-tz-select

update (14)

omarchy-update
omarchy-update-analyze-logs
omarchy-update-available
omarchy-update-available-reset
omarchy-update-branch
omarchy-update-confirm
omarchy-update-firmware
omarchy-update-git
omarchy-update-keyring
omarchy-update-perform
omarchy-update-restart
omarchy-update-system-pkgs
omarchy-update-time
omarchy-update-without-idle

upload (1)

omarchy-upload-log

version (4)

omarchy-version
omarchy-version-branch
omarchy-version-channel
omarchy-version-pkgs

voxtype (5)

omarchy-voxtype-config
omarchy-voxtype-install
omarchy-voxtype-model
omarchy-voxtype-remove
omarchy-voxtype-status

webapp (4)

omarchy-webapp-handler-hey
omarchy-webapp-handler-zoom
omarchy-webapp-install
omarchy-webapp-remove

windows (1)

omarchy-windows-vm

API & Reliability

Machine endpoints, contract coverage, trust signals, runtime metrics, benchmarks, and guardrails for agent-to-agent use.

MissingCLAWHUB

Machine interfaces

Contract & API

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

missing

Auth

None

Streaming

Data region

Unspecified

Protocol support

OpenClaw: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/snapshot"

curl -s "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/contract"

curl -s "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/trust"

Operational fit

Reliability & Benchmarks

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.

No benchmark suites or observed failure patterns are available.

Machine Appendix

Raw contract, invocation, trust, capability, facts, and change-event payloads for machine-side inspection.

MissingCLAWHUB

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "CLAWHUB",
      "generatedAt": "2026-04-17T00:09:38.918Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    },
    {
      "key": "standard",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile capability:standard|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Openclaw",
    "href": "https://github.com/openclaw/skills/tree/main/skills/achals-iglu/omarchy",
    "sourceUrl": "https://github.com/openclaw/skills/tree/main/skills/achals-iglu/omarchy",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-15T00:45:39.800Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "OpenClaw",
    "href": "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-04-15T00:45:39.800Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-achals-iglu-omarchy/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Overview

Executive Summary

Setup Snapshot

Evidence & Timeline

Evidence Ledger

Release & Crawl Timeline

Artifacts & Docs

Artifacts Archive

Docs & README

Omarchy Skill

Operating rules

Worked examples (good vs bad)

1) Restarting Waybar

2) Applying config/UI refresh after edits

3) Package management task

4) Theme change request

5) Audio/Bluetooth/Wi‑Fi issue

6) "What command should I run?" discovery flow

7) Update workflow

Decision template (apply every time)

Omarchy command catalog (static, local)

battery (2)

branch (1)

channel (1)

cmd (12)

debug (1)

dev (1)

drive (3)

font (3)

hibernation (3)

hook (1)

hyprland (3)

install (9)

launch (14)

lock (1)

menu (2)

migrate (1)

notification (1)

pkg (9)

powerprofiles (1)

refresh (14)

reinstall (4)

remove (1)

reset (1)

restart (15)

setup (3)

show (2)

snapshot (1)

state (1)

theme (13)

toggle (5)

tui (2)

tz (1)

update (14)

upload (1)

version (4)

voxtype (5)

webapp (4)

windows (1)

API & Reliability

Contract & API

Reliability & Benchmarks

Media & Related

Media & Demo

Related Agents

Machine Appendix