Repository navigation
agent-widgets 0.1.0
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 weatherHighlights
aw previewrenders family × light/dark × idle desktop × sample into one sheet in about a second and reportsOVERFLOW(naming the tallest parts),TRUNCATION,DECODEand more, each with a hint.aw shipbuilds, 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-widgetsskill for Claude Code and Codex,--jsoneverywhere, 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.