Pup - the AI's own browser
Public Made by Adomby adom
pup gives your AI a real browser on your desktop that it drives completely, in the background, signed in as you: windows that never jump in front of your work, one shared profile that learns your logins, and every window labeled on the taskbar with its AI thread's name.
e1a9528
18d ago
Taskbar identity and jump lists
pup labels every window on the Windows taskbar so you can tell at a glance which AI thread owns it and what it is showing. This guide covers the default look, the alternatives, the right-click menu, and the one setting that changes how that menu opens.
Thread tiles (the default)
Each AI thread gets one taskbar button whose icon is the thread's name, drawn on the Adom teal tile, bottom-left, in a heavy grotesk face. All windows of that thread group under that one button, and the button's title is the thread name. The name wraps onto two lines on a hyphen or space, keeps a minimum size, and is shortened rather than shrunk to nothing, so even long names stay readable.
pup draws the tile itself, inside its own program, at every size Windows asks for (16 to 256 pixels). Each size is drawn at four times its resolution and averaged down, so the letters sit at their exact positions with smooth edges instead of being snapped to whole pixels. The tile is stamped onto the window before the window first appears, so a button never starts as a plain browser icon and changes a moment later.
The favicon badge
The badge in the button's top-right corner is the active tab's own favicon, placed on a small card that turns light when the favicon is dark, so dark logos such as GitHub's stay visible. It follows the active tab, so switching tabs updates it. When a page has no favicon, pup draws a neutral globe (or a document mark for PDFs) and tries again once the page settles. The badge is drawn at 75 percent of full size by default so it does not cover the thread name's bottom line; Settings offers 50, 66, 75 and 100 percent.
Six display modes
The look is one choice with three options, crossed with badges on or off:
| mode | buttons | icon |
|---|---|---|
| tiles + badge (default) | one per AI thread | the thread name tile, with the page's favicon |
| tiles | one per AI thread | the thread name tile, no badge |
| aumid + badge | one per window, or grouped by kind | a pup icon for the kind of page (wiki signed in, wiki public, an Adom app, the open web, mixed), with the favicon |
| aumid | same | the kind-of-page icon, no badge |
| plain + badge | all pup windows stack under the stock browser button | the browser's own icon, with the favicon |
| plain | same | nothing that marks it as pup |
Switch in Settings by clicking a row of the matrix, or ask your AI to change taskbarMode. A switch re-labels every open window at once. The window you are actively using keeps its old button until you look away, because rebuilding a button means briefly hiding the window, and pup will not blink the window you are working in.
Jump lists: the right-click menu
Right-click a pup tile and its jump list offers:
- Annotate this page: draw on the page with a pen, arrows, boxes or text. When you finish, the marked-up capture is copied to your clipboard and sent to the AI thread that owns the window.
- Open pup dashboard: the live map of every window (The dashboard).
- Close ALL Adom Pup windows: every pup window, from every thread, closed for good.
- On Adom wiki windows, Switch to logged-in view and Switch to public view flip the same window between what you see and what the public sees.
Each task calls pup's own signed program directly. Your click counts as you, so it can act on any thread's window without a takeover, and a raise for your click comes with no warning toast.
The first right-click and the Start Menu anchor
On some Windows builds the jump list of a new pup button only opens on the second right-click: the first one flashes and closes. Windows loads a button's menu late when the button's identity has no Start Menu shortcut, and the only reliable fix is a visible shortcut. Measured on 2026-09-23: with no shortcut, a Windows 11 25H2 machine at build 26200.9457 needed two right-clicks every time, while a machine on build 26200.9550 opened the menu on the first click.
The Start Menu anchor setting (aumidShortcut, off by default) adds one shortcut per live window in an "Adom Pup" Start Menu folder and fixes the first click on every build. It is off by default because most people never open a jump list and a Start Menu entry per thread is clutter. The shortcuts are removed when their windows close.
# Taskbar identity and jump lists
pup labels every window on the Windows taskbar so you can tell at a glance which AI thread owns it and what it is showing. This guide covers the default look, the alternatives, the right-click menu, and the one setting that changes how that menu opens.
## Thread tiles (the default)
Each AI thread gets one taskbar button whose icon is the thread's name, drawn on the Adom teal tile, bottom-left, in a heavy grotesk face. All windows of that thread group under that one button, and the button's title is the thread name. The name wraps onto two lines on a hyphen or space, keeps a minimum size, and is shortened rather than shrunk to nothing, so even long names stay readable.
pup draws the tile itself, inside its own program, at every size Windows asks for (16 to 256 pixels). Each size is drawn at four times its resolution and averaged down, so the letters sit at their exact positions with smooth edges instead of being snapped to whole pixels. The tile is stamped onto the window before the window first appears, so a button never starts as a plain browser icon and changes a moment later.
## The favicon badge
The badge in the button's top-right corner is the active tab's own favicon, placed on a small card that turns light when the favicon is dark, so dark logos such as GitHub's stay visible. It follows the active tab, so switching tabs updates it. When a page has no favicon, pup draws a neutral globe (or a document mark for PDFs) and tries again once the page settles. The badge is drawn at 75 percent of full size by default so it does not cover the thread name's bottom line; Settings offers 50, 66, 75 and 100 percent.
## Six display modes
The look is one choice with three options, crossed with badges on or off:
| mode | buttons | icon |
|---|---|---|
| tiles + badge (default) | one per AI thread | the thread name tile, with the page's favicon |
| tiles | one per AI thread | the thread name tile, no badge |
| aumid + badge | one per window, or grouped by kind | a pup icon for the kind of page (wiki signed in, wiki public, an Adom app, the open web, mixed), with the favicon |
| aumid | same | the kind-of-page icon, no badge |
| plain + badge | all pup windows stack under the stock browser button | the browser's own icon, with the favicon |
| plain | same | nothing that marks it as pup |
Switch in [Settings](settings.md) by clicking a row of the matrix, or ask your AI to change `taskbarMode`. A switch re-labels every open window at once. The window you are actively using keeps its old button until you look away, because rebuilding a button means briefly hiding the window, and pup will not blink the window you are working in.
## Jump lists: the right-click menu
Right-click a pup tile and its jump list offers:
- **Annotate this page**: draw on the page with a pen, arrows, boxes or text. When you finish, the marked-up capture is copied to your clipboard and sent to the AI thread that owns the window.
- **Open pup dashboard**: the live map of every window ([The dashboard](dashboard.md)).
- **Close ALL Adom Pup windows**: every pup window, from every thread, closed for good.
- On Adom wiki windows, **Switch to logged-in view** and **Switch to public view** flip the same window between what you see and what the public sees.
Each task calls pup's own signed program directly. Your click counts as you, so it can act on any thread's window without a takeover, and a raise for your click comes with no warning toast.
## The first right-click and the Start Menu anchor
On some Windows builds the jump list of a new pup button only opens on the second right-click: the first one flashes and closes. Windows loads a button's menu late when the button's identity has no Start Menu shortcut, and the only reliable fix is a visible shortcut. Measured on 2026-09-23: with no shortcut, a Windows 11 25H2 machine at build 26200.9457 needed two right-clicks every time, while a machine on build 26200.9550 opened the menu on the first click.
The **Start Menu anchor** setting (`aumidShortcut`, off by default) adds one shortcut per live window in an "Adom Pup" Start Menu folder and fixes the first click on every build. It is off by default because most people never open a jump list and a Start Menu entry per thread is clutter. The shortcuts are removed when their windows close.