Make a Widget
You can get a widget three ways: have the Widget Builder make one from a sentence you type, install a plugin that brings one, or push one from your own script. This page helps you pick, then walks the no-code road from your sentence to a widget you press Load on.
On this page
What it is
A widget is a small live view of something — a number, a short list, a status, a chart — that sits in Omniscio and updates itself. Widgets live in two places: the top bar beside the account switcher, and the widget sidebar, a panel beside your sessions that you switch on when you want it.
There is more than one way to get one, and they are for different people:
| If you are | The way | What it takes |
|---|---|---|
| Someone who does not code and wants a specific thing shown | The Widget Builder — you describe it in plain words and an AI session builds it | A sentence, and one paid AI session per build |
| Using a plugin somebody made that brings a widget | Install it from the Marketplace, then press Load beside its widget | Nothing to build |
| Comfortable writing code, and want the widget inside your own plugin | The plugin SDK's widget guide | A small plugin, or a widget added to one you have |
| Running your own script and want a readout | Script widgets — your script sends the widget through the local API | A script, and the top bar switched on |
Most people who do not code want the first row. The rest of this page is that road. If you do write code, Build a Widget is the developer's version of the same path.
Where to find it
- The Widget Builder is a sidebar page in the Automation group. You can also reach it from the Widget Library (Settings, Widget Library) with its Make your own widget with AI button.
- Your widgets — the ones you made — appear on the Widget Builder page and in the Widget Library, with a Load button beside each.
- A widget you loaded appears in the top bar, or in the widget sidebar once you have added it there from the sidebar's Add picker.
- The widget sidebar itself is off until you turn it on in Settings. Until then, a widget you build belongs in the top bar.
How it behaves
The no-code road, step by step
Say where it should go. With the widget sidebar switched on, the Widget Builder shows a Where should the widget go? choice — Top bar or Sidebar. It starts on Sidebar. With the sidebar switched off there is no choice and the widget goes in the top bar.
Describe what you want, or pick a template. Type a sentence such as "show how many pull requests are waiting on me" in the box. Or start from a template — Countdown, Website up or down, Weather — and answer only what it asks for. The examples on the page are there to borrow from.
Press Build. Pressing Build starts one real AI session, billed like any other. Nothing starts by opening the page, and pressing Build twice quickly still starts one session.
Watch it being built. The build appears under Building now with its state. Open it if you want to talk to the session. While it is still building, the widget can show as Refused under Your widgets — that only means it is not finished.
Read the result. Before it says the widget is ready, the session asks Omniscio whether the folder would load, using the same check the Load button uses, and fixes anything refused. If it cannot reach that check it stops and tells you.
Fix a refusal with Rebuild. A widget that comes back Refused has a reason beside it. Rebuild as widget-only starts a new build from the same description, and with the choice left alone it rebuilds for the same place it was heading.
Press Load. A finished widget waits under Your widgets until you press Load. Loading is your click and nobody else's; it gives the widget widget-only powers, so it can draw a widget and nothing more — unless you built it as a power widget (see below), in which case Load first shows you exactly what it wants and asks you to trust it.
Find it where you put it. A top bar widget appears in the top bar. A sidebar widget appears in the widget sidebar after you add it from Add — the tile is not placed for you.
Power widgets
Some ideas need more than a drawn tile: something that checks a build in the background, runs a program you already have, or keeps its own small service. For those, switch on Let this widget run code and programs on my computer under the box on the Widget Builder page. It is off every time the page opens, and with it off the builder writes the same widget-only widget it always has.
- You still review everything. Loading a power widget does not load it. It shows a sheet listing every power it asks for — the exact programs by name, the exact command-line endpoints, and each extra access with its own description — and the widget cannot run until you press Load and trust this widget for that one widget.
- The trust is tied to its code. If any file in that widget's folder changes, it switches itself off — straight away and again at the next start — and its row says Code changed until you review it again. Keep a widget's own data out of its folder for that reason; its plugin storage is the place for it.
- It never travels. Sharing a sidebar setup shares which widget sits where, never its powers or its trust. A widget folder from another computer arrives with no trust at all.
- You can take it back. Untrust on a loaded power widget switches it off and forgets the trust; the next Load asks you again.
What makes a good description
- Say the number or the fact you want to see, not the layout: "how many of my sessions are waiting on me" beats "a box with a number in the corner".
- Say where the information lives if it is somewhere specific — a website, a folder, a project.
- Keep it to one thing. A widget is one glance. Two unrelated numbers in one widget are two widgets.
- Templates are the shortest route for a date countdown, a site that is up or down, and the weather.
What a widget may not show
A widget shows a short piece of text, a meaning and a name from Omniscio's own small icon list — never colours, images or text that could pass for an app message — and the exact limits and the full shape list are in the widget reference for developers.
Removing one
- A top bar widget is removed from the Widget Library (Settings, Widget Library), where the same row that added it takes it away again.
- A sidebar tile is removed in the widget sidebar itself, with its remove control and an Undo.
- A widget you no longer want to keep is a folder in your Omniscio Widgets folder. Open that folder from the Your widgets section and delete the folder to discard the draft.
Related
- Widget Builder - the page where you describe a widget and press Build.
- Widget Library - every widget in one place, Your widgets, Load and Add/Remove.
- Widget Sidebar - the panel beside your sessions, and how to turn it on.
- Plugin Widgets - how a plugin shows a live widget in the top bar.
- Script Widgets - how your own script shows a widget.
Last verified 2026-11-20