Point-and-click annotation for AI agents on Rails. Tune the toolbar below and copy the exact config — then try the annotation flow.
Change the options; the preview and the initializer update in real time.
Requires Ruby ≥ 3.2, Rails ≥ 7.0. Works on SQLite, MySQL, PostgreSQL. The generator mounts the engine, injects the toolbar, and writes an initializer. Full guide: Installation.
| Option | Default | Does |
|---|---|---|
toolbar_enabled |
true | Master switch for the toolbar system. |
fab_visible |
true | Show the FAB (pins/panel stay if hidden). |
toolbar_position |
bl | Corner: bl/br/tl/tr. |
toolbar_size |
default | slim 32 / compact 40 / default 48px. |
toolbar_accent |
indigo | indigo/amber/blue/emerald/rose. |
base_controller_class |
— | Auth-enforcing parent controller. |
per_page |
25 | Dashboard page size. |
Full reference: Configuration.
The agent reads pending annotations, watches for new ones, transitions status, and replies — each read carries the exact element, page, intent, and screenshot. Details: MCP & agents.
| Command | Does |
|---|---|
init |
Interactive setup wizard. |
server / mcp
|
Start HTTP+MCP / MCP-only. |
pending / watch
|
Fetch / watch annotations. |
resolve ID / dismiss ID
|
Transition an annotation. |
setup-production |
Token + production access. |
Every command: CLI.
Click the button, then click any element to leave a numbered annotation — exactly like in your app.
Start free. Upgrade when your team grows.