Repository navigation
A gallery with a reason to install
Seven ready-made widgets ship with the engine. aw gallery lists them, aw gallery add <id> copies one into your workspace — feed, samples and tests included.
- ai-limits — what is left of your Claude and Codex windows, the pace against an even spend, a forecast of when you run out and a week of history
- agents — which Claude Code and Codex sessions wait for you, went silent or are working, with live timers
- github — contribution year, streaks, the review queue, the last 14 days
- ai-spend — your Claude Code tokens at API prices: today, week, month, by model
- tiles — 2048 played with widget buttons
- system-pulse and focus, redrawn
aw gallery add ai-limits && aw feed run ai-limits && aw ship ai-limitsBig widgets that earn their size
The preview now measures the largest empty area of every size and warns with UNDERFILLED; the sheet outlines the hole. Templates fill the sizes they declare, and the skill is rewritten around a ladder — each size answers a bigger question. On the same brief a fresh agent went from an extra large widget that was 71 % empty to 15 %.
Three more ways to install
- npm —
npm install -g agent-widgets, or straight into an MCP config:npx -y agent-widgets mcp --workspace ~/Widgets - Claude Desktop — download
agent-widgets-0.4.0.mcpbbelow and open it - MCP registry —
io.github.Surdeddd/agent-widgets
aw_init creates the workspace from an MCP client, so clients without a shell can start from an empty folder.
Also
- Feeds that print the same output while nothing changed cost no reloads; the gallery feeds are built that way, and a change reaches the desktop about a second after it is published.
- System date text follows the widget language;
context.localefor your own formats. AWSparkline(values, range: 0...100)pins the scale of a percentage.- Sample dates can be offsets from now:
"+90m","-4m". SAMPLE_NOT_LOCALIZEDonly for feeds that readAW_LANG.
Full list: CHANGELOG.
Upgrade: brew upgrade agent-widgets, or git pull && make install.