Skip to content

agent-widgets 0.4.0

Latest

Choose a tag to compare

@Surdeddd Surdeddd released this 19 Sep 19:57

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-limits

Big 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.mcpb below 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.locale for 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_LOCALIZED only for feeds that read AW_LANG.

Full list: CHANGELOG.

Upgrade: brew upgrade agent-widgets, or git pull && make install.