← All topics

Let AI push content to a widget (push widgets)

Getting startedAll platforms

A push widget is a widget your AI fills in: tell the AI what you want to see and how often, and it pushes content to the widget on that schedule — using a ready-made template, or a design it draws itself. For example, "every morning at 8, push today's weather and three tech headlines" or "whenever a deploy finishes, tell me whether it worked".

You need an AI that can run commandsFor example Claude Code, Codex, or your own script. Chat-only AI (the kind you only talk to in a web page) can't push. Creating a push widget also requires signing in to your Numable account.

How to use it:

  1. Open the panel at the top right of your dashboard, tap "Use AI", then "Let AI push content to a widget".
  2. Tap "New push widget" and add a size to your dashboard.
  3. Long-press the widget, choose "Edit parameters", then "Connect".
  4. Write what you want the AI to push (or tap an example), tap "Copy for AI" and send what you copied to your AI.
  5. Scheduling is set up on the AI's side (for example its scheduled tasks). Once the AI pushes, the widget updates by itself; long-press it and choose "Update" to update right away.
The access key is shown only onceWhat you copy for the AI includes this widget's access key — any AI or script with it can push to this widget, so only give it to an AI you trust. If you lose it, create a new one in Edit parameters; if you no longer need the widget, tap "Disconnect and delete pushed content" and every key you handed out stops working.

Where the content is kept: pushed content is kept on our servers, latest copy only — each push replaces the previous. It's deleted immediately when you disconnect or delete the widget, and automatically after 90 days with no reads or writes. Devices that have the widget can read it (including people you share the widget with, and your backups and synced devices). Please don't have the AI push passwords, ID numbers or bank card numbers.

The widget doesn't change: first check whether the AI reported a successful push — if a push is rejected, the AI gets the exact reason. The widget picks up new content on its refresh schedule; long-press it and choose "Update" to update right away.

If you don't see "Use AI" in the panel at the top right of your dashboard, update Numable to the latest version first.

Related
Where is my data stored?›Add your first widget›My home screen widget isn't updating›
Opening Help inside Numable gives you search — and works offline.