plugin-omarchy

Placement	runtime (out-of-process over gRPC)
Source	github.com/opencharly/plugin-omarchy/candy/plugin-omarchy
Candy	plugin-omarchy

This plugin is not listed in charly/charly.yml’s compiled_plugins:. It is not part of the shipped binary: charly builds and loads it out-of-process over gRPC when a plan references one of its words (the coexist path).

Providers

The reserved words this plugin serves:

• omarchy — verb class

What it does

The omarchy CLI surface as a charly check verb. Dispatches the omarchy command center (version, debug, capture, lock, theme, audio, bar, battery, bluetooth, brightness, channel, clipboard, cmd, config, default, dev, font, menu, migrate, network, plugin, power, system, theme, update, upload, voxtype, weather, webapp, windows, and more) to the guest over the executor reverse channel, so a check bed can assert and drive the installed Omarchy’s own tooling — the same commands the Omarchy menu and hotkeys use.

Parameter schema

The CUE schema below is the authoritative grammar for this plugin’s input. It is the same single source that generates the plugin’s Go parameter types and answers the runtime Describe RPC, so this page cannot disagree with either.

schema/omarchy.cue

#OmarchyInput: {
  // method — the omarchy surface to dispatch. "cli" (default) runs
  // `omarchy <args>` (the command center); the shell-ipc methods run the
  // omarchy-shell IPC (the SAME surface the menu and hotkeys use); the
  // cli-read methods run the omarchy-* bin commands (the acceptance
  // surfaces the beds assert).
  method: "cli" | "shell-ping" | "shell-summon" | "shell-hide" |
    "shell-list-plugins" | "shell-reload-config" |
    "shell-notifications-dismiss" | "shell-notifications-send" |
    "channel-current" | "default-browser" | "default-terminal" |
    "default-editor" | "theme-current" | "theme-bg-current" |
    "font-current" | "weather-location" | "version" | *"cli"
  // args — the omarchy CLI args (method: cli) or the weather-location
  // args (method: weather-location). Required for those two methods.
  args?: string @go(Args)
  // plugin — the omarchy.<plugin> id for shell-summon / shell-hide.
  plugin?: string @go(Plugin)
  // payload — the JSON payload for shell-summon (optional).
  payload?: string @go(Payload)
  // title / text — the notification title/body for shell-notifications-send.
  title?: string @go(Title)
  text?: string @go(Text)
  // expect_non_zero: assert the command FAILED (any non-zero exit) — the
  // CLI-rejects-X class. Mirrors plugin-command's expect_non_zero; mutually
  // exclusive with the step-level exit_status matcher (exact code).
  expect_non_zero: bool | *false @go(ExpectNonZero)
}

---

See also the candy reference for this candy’s install surface.