Back
agentsproductivityOpen source

TipTour

A macOS menu-bar companion where Jev chooses click targets from controls detected locally on screen.

What Jev decides

Which visible control to click next, which click form to use, or whether the task is complete or blocked.

In Jev mode, TipTour reads labels and locations through its local grounding engine, asks Jev for the next click target, executes the action, and validates the result until completion or a bounded stop.

CHOICE
Jev role
Choose the next compatible click action and target from controls found by the local macOS grounding engine.
Input
The typed goal, locally detected control labels and locations, and recent action history.
Output
A bounded Choice over available click actions and targets.
Decision frequency
Once per step in a Jev-mode desktop task, up to 12 actions.
Fallback
Stop on completion, no suitable target, cancellation, execution pause or failure, or the action limit; Jev mode does not fall back to Gemini automatically.
Author reported · Source reviewed

How it works

Input
The typed goal, locally detected control labels and locations, and recent action history.
Jev
CHOICE
Output
A bounded Choice over available click actions and targets.

Overview

TipTour combines a local macOS grounding and action engine with two separate modes. In Jev text mode, the user types a click-based goal and Jev chooses among controls detected locally from screen and accessibility information. The app performs single, double, or right clicks, reads the interface again, and continues until Jev reports completion or none, an action fails, the user stops it, or the 12-action limit is reached.

Jev receives the typed task, detected labels and locations, and recent action history; screenshots remain local. This mode cannot interpret images, generate replacement text, or perform keyboard actions. The separate Gemini realtime mode has different capabilities and data handling and should not be attributed to Jev.

Language
Swift
License
MIT
Author
Milind Soni
Sources checked Sep 22, 2026

Sources

Related projects