Skip to content

agent-widgets 0.1.0

Choose a tag to compare

@Surdeddd Surdeddd released this 14 Sep 01:02
· 58 commits to main since this release

First public version of agent-widgets: a harness that lets coding agents build native macOS desktop widgets. The agent writes a Codable model, a SwiftUI view and, for live data, a small feed script; aw previews every size and theme with layout checks, builds and signs the app, installs it with backups, shows the widget in a dev slot on the desktop and captures the real window.

git clone https://github.com/Surdeddd/agent-widgets && cd agent-widgets
make install && aw doctor
aw init ~/Widgets && cd ~/Widgets
aw new weather --template metric && aw preview weather && aw ship weather

Highlights

  • aw preview renders family × light/dark × idle desktop × sample into one sheet in about a second and reports OVERFLOW (naming the tallest parts), TRUNCATION, DECODE and more, each with a hint.
  • aw ship builds, installs atomically with three backups, keeps the installed app the only registered widget extension, points the dev slot at the widget and screenshots it.
  • Feeds in any language, published only on change and scheduled by a LaunchAgent; buttons with state that do not spend the reload budget.
  • MCP server with 11 tools (the preview tool returns the sheet image), the agent-widgets skill for Claude Code and Codex, --json everywhere, English and Russian throughout.
  • Eight example widgets, each written by a fresh agent from a one-paragraph brief and the skill.

Requirements: macOS 14+, Xcode 16.3+, brew install xcodegen, an Apple Development certificate. Full list of changes in CHANGELOG.md.