native-widgets

Display real-time project status in native OS widgets via a JSON contract.

3|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/orchestra-mcp/framework --skill native-widgets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: native-widgets
Source: https://github.com/orchestra-mcp/framework/tree/main/.claude/skills/native-widgets
Command: npx skills add https://github.com/orchestra-mcp/framework --skill native-widgets

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a consistent and integrated way to display project status and key information directly within your operating system's native widget system, keeping you informed without needing to constantly switch contexts.

Core Features & Use Cases

  • Cross-Platform Support: Works on macOS (WidgetKit), Windows (Adaptive Cards), and Linux (GNOME/KDE).
  • Real-time Project Info: Displays active project, Git branch, sync status, and file changes.
  • Use Case: As a developer, you can glance at your desktop widgets to see if your current project is synced and what branch you're on, allowing for quick context switching and status checks.

Quick Start

Update the native widgets with the latest project information.

Frequently Asked Questions about native-widgets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I display real-time project status in native OS widgets across macOS, Windows, and Linux?

To display real-time project status in native OS widgets, your Go application writes to a platform-agnostic JSON data contract that native widget layers consume, updating information like Git branch and sync status automatically.

Does this native widget integration support macOS WidgetKit and Windows Adaptive Cards?

Yes, native widget integration supports macOS WidgetKit, Windows Adaptive Cards, and Linux GNOME/KDE environments to render project status information using each operating system's specific native UI mechanisms.

What is the JSON data contract mechanism for updating cross-platform native widgets?

The JSON data contract is a platform-agnostic data structure that Go applications write to and native widget layers consume, serving as the seamless integration bridge for real-time project information updates.

How do I show Git branch and file change status on my desktop without switching IDE contexts?

You can show Git branch and file change status on your desktop by writing active project information to the JSON data contract, allowing native widgets to display real-time updates directly on your operating system.

Can I use Go applications to push automatic updates to native desktop widgets?

Yes, Go applications can push automatic updates to native desktop widgets by writing to the JSON data contract, which triggers platform-specific update mechanisms like WidgetKit, Adaptive Cards, and DBus notifications.