overthinkos/wl-overlay
ov-layers/skills/wl-overlay/SKILL.md
Wayland overlay windows via gtk4-layer-shell (for screen recordings). Use when working with the wl-overlay layer, gtk4-layer-shell, or overlay dependencies.
testing
Updated Apr 27, 2026
$ install --global
skillsauthnpx skillsauth add overthinkos/overthink-plugins wl-overlayInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 27, 2026, 9:35 AM73.7s1 file scanned
SKILL.md
- name:
- wl-overlay
- description:
- |
wl-overlay -- Wayland overlay windows via gtk4-layer-shell
Layer Properties
| Property | Value |
|----------|-------|
| Dependencies | dbus |
| Install files | tasks:, ov-overlay |
Packages
gtk4(RPM)gtk4-layer-shell(RPM) — includesGtk4LayerShell-1.0.typelibfor GObject Introspectionpython3-gobject(RPM)
Technical Details
Python Script: ov-overlay
Installed to ~/.local/bin/ov-overlay via tasks:. Dual-mode script (daemon + client) using GTK4 + gtk4-layer-shell for layer-shell protocol overlays.
Key implementation details:
- Shebang:
#!/usr/bin/python3(system Python 3.14, NOT pixi's Python — PyGObject is an RPM package) - Library preload:
CDLL("libgtk4-layer-shell.so.0")must load before GTK4 import (registers layer-shell protocol before Wayland display init). Uses versioned soname.so.0(unversioned.sois in-develpackage only) - RGBA surfaces:
window { background: none; }CSS applied globally at daemon startup. Without this, GTK4 on Wayland creates opaque surfaces that don't support alpha transparency - Cairo backgrounds: all overlay backgrounds drawn via
Gtk.DrawingArea+ Cairopaint(). GTK4 CSSbackground-colorwithrgba()does not composite correctly on layer-shell windows - Thread safety: socket listener runs in a separate thread; all GTK operations dispatched via
GLib.idle_add() - IPC: Unix domain socket at
/tmp/ov-overlay.sockwith JSON-line protocol
Layer-Shell Configuration
- Layer:
OVERLAY(above TOP where waybar/swaync live) - Keyboard mode:
NONE(overlays never capture input) - Exclusive zone:
-1(don't push other windows) - Namespace:
ov-overlay-<name>per overlay window
Usage
# image.yml — typically included via desktop metalayers
# Already part of sway-desktop, selkies-desktop, niri-desktop
my-desktop:
layers:
- wl-overlay
ov test wl overlay show my-image --type text --text "Hello" --name intro
ov test wl overlay list my-image
ov test wl overlay hide my-image --all
Used In
/ov-layers:sway-desktop— sway desktop composition/ov-layers:selkies-desktop— selkies streaming desktop composition/ov-layers:niri-desktop— niri desktop composition
Used In Images
/ov-images:sway-browser-vnc(viasway-desktopmetalayer)/ov-images:openclaw-sway-browser(viasway-desktopmetalayer)/ov-images:openclaw-ollama-sway-browser(viasway-desktopmetalayer)/ov-images:selkies-desktop(viaselkies-desktopmetalayer)/ov-images:selkies-desktop-nvidia(viaselkies-desktopmetalayer)
Related Layers
/ov-layers:dbus— D-Bus session bus (dependency, required by GTK4)/ov-layers:wl-tools— Wayland automation tools (sibling in desktop stack)/ov-layers:a11y-tools— also usespython3-gobject(RPM deduplication handles overlap)/ov-layers:tmux— tmux (required for overlay daemon hosting)
Related Commands
/ov:wl-overlay— Overlay command usage, types, recording workflow/ov:wl— Compositor-agnostic desktop automation/ov:record— Recording commands (overlays compose with recording)
Related
/ov:layer— layer authoring reference (layer.ymlschema, task verbs, service declarations)/ov:test— declarative testing (tests:block,ov image test,ov test)
Related Skills
overthinkos/agents
development
VerifiedTrustedCommunity
Claude Code multi-agent support in Overthink — sub-agents, dynamic workflows, and agent teams, and how each drives the existing `ov eval` disposable beds to test and verify. MUST be invoked before authoring or invoking an ov sub-agent / dynamic workflow / agent team, wiring agent-lifecycle hooks, or asking "which primitive should drive the R10 beds?".
SKILL.mdUpdated May 31, 2026
overthinkos/workspace-mount
tools
VerifiedTrustedCommunity
Mounts a virtiofs share tagged `workspace` at /workspace inside a VM guest via a systemd .mount unit. Use when a kind:vm entity shares a host directory into the guest and you need it auto-mounted (and re-mounted at every boot).
SKILL.mdUpdated May 30, 2026
overthinkos/android
development
VerifiedTrustedCommunity
MUST be invoked before any work involving: the `kind: android` schema kind, a `target: android` deploy, the `apk:` layer package format (installing Android apps declaratively), AndroidDeployTarget, an in-pod emulator OR a remote/physical adb-endpoint device, or nested `pod → android` deployment. The first-class Android device + app surface that sits above `ov eval adb`/`appium`.
SKILL.mdUpdated May 26, 2026
overthinkos/git-workflow
tools
VerifiedTrustedCommunity
Use when committing, branching, pushing, merging, tagging, creating PRs, or approving/merging PRs with gh — the feat/-branch, R10-gated, never-force-push landing workflow across the main repo + the plugins submodule + image/<distro> submodules. Covers sync-to-upstream, branch/worktree pruning, the fork+PR path for contributors without write access, and cross-repo @github landing order.
SKILL.mdUpdated May 25, 2026