WidgetDesk macOS Widget Manager for Openclaw

A professional toolset for managing Übersicht desktop widgets on macOS through automated scripts and JSX templates.

paranoidearth
v0.1.0
Mar 9, 2026
0
977
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install widget

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install widget using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is WidgetDesk macOS Widget Manager?

WidgetDesk is a sophisticated skill designed to bridge the gap between AI agents and the macOS desktop environment. By leveraging the Übersicht platform, it allows users to programmatically create, toggle, and maintain desktop widgets that range from system monitors to productivity timers. As part of the Openclaw Skills ecosystem, WidgetDesk focuses on providing a native-feeling experience by enforcing strict design constraints and implementation rules.

This skill is particularly valuable for users who want to customize their workspace without manual configuration. It handles everything from environment setup and dependency checks to the generation of dark, translucent, macOS-style interface components using React and shell commands.

WidgetDesk macOS Widget Manager Use Cases

  • Deploying system resource monitors like CPU, memory, and battery stats directly to the desktop.
  • Setting up productivity tools such as Pomodoro timers or interactive tap counters.
  • Visualizing local Git activity via heatmaps or tracking current music playback.
  • Creating glanceable information hubs for weather, time, and date with custom CSS styling.
  • Building quick-note capsules that persist on the desktop for rapid information capture.

How WidgetDesk macOS Widget Manager Works

  1. The skill begins by executing a setup script that verifies the presence of Übersicht and configures the necessary local directory structures.
  2. It analyzes user requests to determine if a built-in template can be used or if a custom JSX widget needs to be generated from scratch.
  3. For custom widgets, it applies a standardized style baseline involving backdrop blurs, specific corner radii, and SF Pro typography.
  4. The generated file is placed in the Übersicht widgets directory, where the host application automatically compiles and renders it.
  5. The skill manages the widget lifecycle, providing operations to hide widgets by renaming them or removing them entirely when no longer needed.

WidgetDesk macOS Widget Manager Setup

To begin using this skill, you must first ensure that Übersicht is installed on your Mac. Then, run the initialization script within the repository:

bash scripts/setup.sh

For ongoing health checks or to diagnose installation issues after the initial setup of these Openclaw Skills, you can use the doctor or check commands:

# Perform a fast post-install health check
bash ~/.claude/skills/widget/scripts/doctor.sh

# Run a dry-run environment check
bash scripts/setup.sh --check

WidgetDesk macOS Widget Manager Data Schema & Taxonomy

WidgetDesk maintains a clear file hierarchy to separate active widgets from templates and scripts. This structure ensures compatibility with the Übersicht host app while keeping the Openclaw Skills assets organized.

Data Type Location
Active Widgets ~/Library/Application Support/Übersicht/widgets/
Skill Templates ~/.claude/skills/widget/templates/
Host Scripts ~/.claude/skills/widget/scripts/
Implementation Patterns patterns.md
Disabled Widgets Filenames ending in .jsx.disabled

WidgetDesk macOS Widget Manager Advanced Features

  • Intelligent layout engine that prevents widgets from overlapping with the macOS dock or system menus.
  • Support for shell-command integration, allowing widgets to display output from any macOS terminal command.
  • Dynamic refresh frequency management, including logic to disable refresh for pure-frontend components.
  • Strict React rule enforcement to ensure stability within the Übersicht runtime, such as preventing direct hook calls in render functions.
  • Pre-configured visual themes that use system-level transparency and blur effects for a cohesive OS appearance.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*