onUI

Anota elementos, dibuja regiones y entrega una interfaz de usuario más limpia más rápido.

Documentación

onUI

Anota cualquier UI para agentes de IA

Extensión de navegador ligera (Chrome + Edge + Firefox) + puente MCP local para programación en pareja de UI centrada en anotaciones.

Desarrollado por onLLM.dev.

[!NOTE] onUI ahora es estable y está listo para producción.

Demostración

_{Haz clic en la vista previa de arriba para reproducir el video de demostración completo.}

✨ Por qué onUI

🧩 Sin integración en el código de la aplicación
🎛️ Control ON/OFF por pestaña (desactivado por defecto)
🎯 Diálogo de anotación en la página con intención + severidad
✍️ Modo dibujo para anotaciones de región (rectángulo + elipse)
⚙️ Barra de herramientas compacta con configuración emergente (nivel de salida + borrar al copiar)
👀 Marcadores visuales y apuntado al pasar el cursor
🧾 Exporta salidas en formatos compacto / estándar / detallado / forense
🛡️ Aislamiento de Shadow DOM para un estilo estable
🔌 Servidor MCP local + puente nativo (sin backend en la nube)

Instalación (Actual)

Opción A: Tiendas de extensiones del navegador (recomendado)

Chrome Web Store: https://chromewebstore.google.com/detail/onui/hllgijkdhegkpooopdhbfdjialkhlkan?authuser=0&hl=en-GB

Microsoft Edge Add-ons: https://microsoftedge.microsoft.com/addons/detail/onui/fkcmlckehjhcicihbnmhkadfhjhfnond

Opción B: Instalador de un comando desde la última versión de GitHub

Usa esto si quieres la última versión (las actualizaciones de la tienda pueden ir con retraso) o para Firefox:

macOS/Linux:

curl -fsSL https://github.com/onllm-dev/onUI/releases/latest/download/install.sh | bash

macOS/Linux (artefacto de Firefox):

curl -fsSL https://github.com/onllm-dev/onUI/releases/latest/download/install.sh | bash -s -- --firefox

Windows (PowerShell):

irm https://github.com/onllm-dev/onUI/releases/latest/download/install.ps1 | iex

Windows (PowerShell, artefacto de Firefox):

iwr https://github.com/onllm-dev/onUI/releases/latest/download/install.ps1 -OutFile install.ps1; .\install.ps1 -Firefox

El instalador maneja la instalación de la extensión y puede configurar MCP en la misma ejecución. Cuando se te solicite Set up local MCP bridge now? [y/N], ingresa y para habilitar MCP.

Luego cárgalo en Chrome o Edge:

Abre chrome://extensions o edge://extensions
Habilita el modo desarrollador
Haz clic en Cargar descomprimida
Selecciona ~/.onui/extensions/current (o %USERPROFILE%\.onui\extensions\current en Windows)

Los navegadores Chromium requieren este paso manual final para extensiones descomprimidas.

Firefox (manual desde el artefacto de la versión):

Descarga onui-firefox-add-ons-vX.Y.Z.zip desde la página de versiones de GitHub.
Extráelo a una carpeta local.
Abre about:debugging#/runtime/this-firefox.
Haz clic en Cargar complemento temporal...
Selecciona el manifest.json extraído.

🧠 Uso

Abre cualquier pestaña de sitio web compatible.
Haz clic en el icono de la extensión onUI.
Habilita This Tab.
Usa el lanzador en la página para abrir la barra de herramientas compacta.
Alterna el modo anotar para apuntar a elementos o el modo dibujar para apuntar a regiones.
Mantén presionado Shift y haz clic en varios elementos para seleccionar objetivos en lote.
Suelta Shift para abrir un diálogo de anotación compartida para los objetivos seleccionados.
Guarda una vez para crear una anotación por elemento seleccionado (o una anotación de región en el flujo de dibujo).
Abre la Configuración de la barra de herramientas para elegir el nivel de salida y configurar Borrar al copiar.
Copia la salida exportada desde la barra de herramientas.

🔌 Configuración local de MCP

Ruta recomendada: usa el mismo comando de instalación de arriba y responde y cuando se te solicite.

Si quieres forzar la configuración de MCP en modo no interactivo:

macOS/Linux (--mcp):

curl -fsSL https://github.com/onllm-dev/onUI/releases/latest/download/install.sh | bash -s -- --mcp

Windows (PowerShell, establece la variable de entorno antes de ejecutar el instalador):

$env:ONUI_INSTALL_MCP=1; irm https://github.com/onllm-dev/onUI/releases/latest/download/install.ps1 | iex

La configuración de MCP ahora usa un paquete de versión precompilado (no se requiere compilación local), pero aún necesita Node 20+.

La configuración manual de MCP desde el código fuente aún es compatible:

pnpm build:mcp
pnpm setup:mcp
pnpm doctor:mcp

Configuración JSON manual para routers/clientes MCP personalizados

Si tu router MCP usa un mapa de estilo objeto mcpServers, usa esta entrada canónica:

{
  "mcpServers": {
    "onui-local": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/onUI/packages/mcp-server/dist/bin/onui-cli.js",
        "mcp"
      ]
    }
  }
}

Usa una ruta absoluta para onui-cli.js (las rutas relativas a menudo son rechazadas o resueltas incorrectamente por los routers).

Si tu router usa un esquema de lista/array en lugar de un mapa de objetos, adapta la misma forma de comando/argumentos así:

{
  "servers": [
    {
      "name": "onui-local",
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/onUI/packages/mcp-server/dist/bin/onui-cli.js",
        "mcp"
      ]
    }
  ]
}

El ejemplo de lista anterior es un patrón de adaptación de esquema, no una afirmación sobre los nombres exactos de claves de ningún router específico.

Notas de configuración/verificación:

Ejecuta pnpm build:mcp primero para que exista packages/mcp-server/dist/bin/onui-cli.js.
Mantén el nombre de entrada del servidor como onui-local.
Ejecuta pnpm doctor:mcp después de conectar la configuración para confirmar el estado de la configuración local.
Registra automáticamente onui-local para Claude Code y Codex cuando esos CLI están instalados.
Soporte de navegador en esta versión: Chrome estable + Edge estable + Firefox estable (descomprimido).
@onui/mcp-server es local al espacio de trabajo (private: true), así que ejecuta setup/doctor desde este repositorio.

Ver:

docs/mcp-setup.md
docs/doctor.md
docs/release.md

Compilación y publicación para mantenedores

app.sh es el punto de entrada de publicación local (sin dependencia de CI/CD).

Validación local + empaquetado de artefactos

./app.sh --build

Esto ejecuta:

Verificaciones de requisitos previos (Node 20+, pnpm, git, zip)
Orden de compilación: @onui/core -> @onui/extension -> @onui/mcp-server
Pruebas de MCP
Verificación rápida de MCP doctor (se permiten advertencias, los errores fallan)
Empaquetado de artefactos en artifacts/vX.Y.Z/

Artefactos:

onui-extension-unpacked-vX.Y.Z.zip
onui-chrome-web-store-vX.Y.Z.zip (manifiesto key eliminado para CWS)
onui-edge-add-ons-vX.Y.Z.zip (manifiesto key eliminado para Edge Add-ons)
onui-firefox-add-ons-vX.Y.Z.zip
onui-mcp-bundle-vX.Y.Z.zip
install.sh
install.ps1
checksums.txt

Publicación local + publicación en GitHub

./app.sh --release

Puertas de publicación:

Árbol git limpio
La rama actual es main
gh auth status tiene éxito

Acciones de publicación:

Incremento automático de parche desde la raíz package.json
Sincronizar la versión en la extensión + cadenas de tiempo de ejecución de MCP
Ejecutar el --build completo
Commit + etiqueta vX.Y.Z
Empujar commit/etiqueta
Crear una versión de GitHub con los activos empaquetados

🛠️ Desarrollo

pnpm install
pnpm check
pnpm test:coverage

🗂️ Estructura del repositorio

packages/
  core/        Shared annotation/report types + formatters
  extension/   Browser extension runtime (background/content/popup)
  mcp-server/  Local MCP server + native bridge setup/doctor tooling

⭐ Soporte

Si onUI te resulta útil, por favor dale una estrella al repositorio: https://github.com/onllm-dev/onUI

Ayuda a otros usuarios a descubrir el producto.

Historial de estrellas

📄 Licencia

GPL-3.0