cow-module-cmd(1)

📦 version 0.3, in fedora 44

💖 cow-module-cmd — bestie edition 💖

okay so this is cow-module-cmd(1), and it lives inside cow - Window Manager. pull up a chair, we're going in 🫶

✨ NAME ✨

cow-module-cmd — the internal commands that cow modules use, no cap

🌸 DESCRIPTION 🌸

so these commands are literally part of the interface between cow(1) and its modules. they're written down for module authors and for debugging — that's the whole point.

lowkey important: these are not meant to be your everyday general configuration commands, bestie. they're the backstage pass, not the front door. 💅

👑 COMMANDS 👑

🎀 show diagnostics

returns read-only, process-lifetime diagnostic counters. iconic. the record has:

  • CoW process CPU, uptime and peak RSS
  • pending and cumulative update counts
  • manage and render cycle counts
  • last, average, and maximum callback and CoW/River hand-off timings

timing values are in microseconds, just so you know ✨

the request_wait measurement covers the first pending manage request all the way to River's manage_start event. and after_manage covers CoW's manage_finish request to River's next render_start event. these are protocol-boundary timings — fr fr — not compositor frame-rendering measurements, so don't get it twisted 🙈

also: the diagnostics have no config representation. none. zero. nada. 💀

🦋 window-tile [-t target] [-e edges] [-u]

sets or clears the tiled-edge hint for a window. slay.

this is used by modules that place and size windows exactly, because some clients use the tiled state to ignore normal resize increments. iykyk 👑

window-tile [-t target] [-e edges] [-u]
  • -t target — the target window. that's it, that's the girl 🎯
  • -e edges — set the tiled edges. edges can be all, none, or any combination of n, s, e, and w. the default is all. periodt 💅
  • -u — clear the tiled-edge hint. bye bestie 👋

🌈 SEE ALSO 🌈

and that's the whole vibe, bestie 💖 this page is version 0.3, dated 2026-09-07 — go forth and debug your modules like the main character you are 🧚✨

📦 where this page comes from