app
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.
← Commit history
settings consolidation (2.0.292): document taskbarActivity as the single taskbar-activity control; remove openFlash/autoFlash/agentActivity/fgWatch from pup-settings; note fgWatch folded into notMineCaption; off-screen-birth intro
2 files changed
+11−10
skills/pup-settings/SKILL.md+7−8@@ -71,18 +71,17 @@ the jump-list task, or the (off-by-default) corner pencil. ## Foreground etiquette — pup never steals your screen -pup opens windows in the BACKGROUND and signals with a taskbar flash instead of stealing focus. When-an AI *does* raise a window, it must give a reason, shown on-screen.+pup opens windows in the BACKGROUND (off-screen birth, moved on-screen within 50ms so Chrome never+activates them) and signals it is working via the taskbar (`taskbarActivity`, default a progress bar)+instead of stealing focus. When an AI *does* raise a window, it must give a reason, shown on-screen+first, THEN it foregrounds. | Key | Default | What it does | |---|---|---|-| `openFlash` | **on** | Flash the taskbar button (accent-colored) when a new pup window opens, so you notice it. |-| `autoFlash` | **on** | Flash a window's button when an AI changes it (navigate/click/type). One flash per burst. |-| `agentActivity` | **on** | Show a progress strip on a window's taskbar button while an AI is actively driving it. |-| `fgWatch` | **on** | For 20s after a background open/navigate, watch if something pulled the window to the front and re-park it. |+| `taskbarActivity` | **progress** | How pup signals it is WORKING on a window, on that window's taskbar button: `progress` = a determinate progress bar sized to the operation's running-average time (icon-apply on open, screenshots); `flash` = the old orange highlight (on open + on a mutating verb); `off` = nothing. This ONE control replaces the former `openFlash`, `autoFlash`, and `agentActivity` toggles. Full detail in the `pup-taskbar-progress` skill. | | `fgCaption` | **on** | When an AI brings a window to your screen, show its stated reason as an on-screen caption. |-| `fgCaptionMs` | **3500** | How long (ms) that foreground-reason caption shows. |-| `notMineCaption` | **off** | Low-importance: when a window fronts itself (JS/focus/Chrome, not pup), briefly caption that Adom did NOT do it. |+| `fgCaptionMs` | **2000** | How long (ms) that foreground-reason caption shows. |+| `notMineCaption` | **off** | The single self-foreground caption control (v2.0.292: folded in the old `fgWatch`). Off by default. When on, pup watches for ~20s after a background open/navigate and, if a window pulls ITSELF to the front (JS/focus/Chrome, not pup), briefly captions that Adom did NOT do it. The window is no longer re-parked — off-screen birth means pup no longer needs a foreground-steal watchdog; this is now purely the "not me" caption. | ## Credential vault — pup manages your logins (no Chrome dialog)
skills/pup-taskbar-progress/SKILL.md+4−2@@ -47,8 +47,10 @@ Notes: - **Windows only.** macOS/Linux have no taskbar, so the setting is stored but inert. - A STOP of a leftover flash, and a human explicitly clicking "flash" in the dashboard, still work regardless of the setting — only pup's own *automatic* flashes are gated off in `progress`/`off`.-- Independent of `agentActivity` (the broader "an AI is driving this window" indeterminate strip);- `taskbarActivity` governs the determinate, operation-sized bar and whether the flash is used.+- **This is now the ONE taskbar-activity control.** As of v2.0.292 it absorbed the former separate+ `openFlash` (flash on open), `autoFlash` (flash on a mutating verb), and `agentActivity` ("an AI is+ driving this" strip) toggles — they are gone. `taskbarActivity: flash` gives the old open+mutate+ flashes; `progress` gives the determinate operation-sized bar; `off` gives neither. ## Talk to pup