ConnecThor logo ConnecThor

Agente local + extension + plugins

ConnecThor conecta apps web con tu entorno local.

Un agente local para filesystem, comandos, terminales, proxy de dev servers y plugins, pensado para que Edithor y otras interfaces web operen un workspace sin mezclar capacidades de producto dentro del core.

connecthor --path ~/workspace --allow whitelist ws://127.0.0.1:7780/ws autenticado plugins: edithor, browser-edithor, browser-github

Que aporta

Primitivas locales con una frontera clara.

ConnecThor ofrece la infraestructura generica. Las capacidades especificas de Edithor, GitHub u otros productos se instalan como plugins.

Filesystem con reglas

Lee, lista, escribe, mueve y elimina ficheros dentro del workspace con modos de seguridad explicitos.

Comandos y terminales

Ejecuta comandos no interactivos con salida en streaming y mantiene sesiones PTY interactivas por WebSocket.

Proxy de dev servers

Detecta servidores locales, los proxifica y puede inyectar el bridge necesario para iframes de desarrollo.

Plugins dinamicos

Instala plugins process y browser para mover capacidades especificas fuera del core generico.

Auth local por token

Usa autenticacion por token, bloqueo temporal ante intentos fallidos y modelo de conexion 1:1.

Puente browser

La extension Chromium mantiene el token, el WebSocket compartido y la mensajeria entre paginas y ConnecThor.

Arquitectura

Core, extension, plugins browser, plugin process y SDK.

La taxonomia evita presentar el plugin de Edithor como core generico: cada pieza tiene una responsabilidad distinta.

Core local

connecthor

Agente Rust con WebSocket/HTTP autenticado, filesystem, comandos, PTY, proxy y runtime de plugins.

Debe mantenerse generico: las APIs de producto viven fuera del core.

Extension Chromium MV3

connecthor-for-browser

Puente entre apps web y ConnecThor. Gestiona token, WebSocket, confirmaciones y plugins browser.

Se carga localmente en Chrome o Edge; la publicacion en stores no esta confirmada.

Plugin browser

connecthor-browser-edithor

Acciones de pagina para Edithor: imagenes, capas, assets, resumenes, sync de iframes y traduccion browser-mode.

Depende de la extension y llama endpoints /edithor/* del plugin process.

Plugin browser site-specific

connecthor-browser-github

Agrega botones de clonado en GitHub para abrir una terminal ConnecThor y ejecutar git clone en el workspace.

No depende de Edithor; usa el puente extension -> HTTP local.

Plugin process Rust

connecthor-plugin-edithor

Backend local especifico de Edithor: Explorer, Git, Terminal, Flows, Tasks, Agent, auth y Orchestrathor.

No es core ConnecThor; encapsula reglas y endpoints propios de Edithor.

SDK de plugins process

connecthor-plugin-sdk

SDKs JavaScript, Python y Rust para handshake JSON-RPC, HTTP local, HostClient, WS handlers y shutdown.

Sirve para crear plugins process, no plugins browser.

Como encajan

Del navegador al workspace sin romper responsabilidades.

  1. La app web solicita una accion local desde Edithor u otra interfaz compatible.
  2. La extension browser valida el canal y traduce mensajes de pagina hacia ConnecThor.
  3. ConnecThor aplica token, reglas de seguridad y deriva al core o al plugin correspondiente.
  4. El resultado vuelve por HTTP/WebSocket para actualizar la UI sin exponer primitivas internas.

Relacion con Edithor

Edithor consume APIs de producto, no primitivas del core.

connecthor-plugin-edithor convierte las capacidades locales en endpoints de alto nivel para Explorer, Git, Terminal, Flows, Tasks, Agent, Storage, Orchestrathor y el puente browser.

Los plugins browser de Edithor y GitHub viven en el navegador; el plugin process vive como proceso local; el SDK permite crear integraciones de servidor nuevas.

Primeros pasos confirmados

Instalacion y uso local sin prometer canales no confirmados.

Arrancar el agente local

connecthor --path ~/mi-proyecto --domains https://edithor.app --allow whitelist

El modo whitelist requiere configuracion explicita del workspace.

Instalar un plugin process

connecthor install ./connecthor-plugin-edithor

El plugin de Edithor tambien se puede instalar desde su flujo de build local confirmado.

Cargar la extension browser

chrome://extensions/ -> Developer mode -> Load unpacked

El repo documenta carga local en Chrome/Edge; no se asume publicacion en stores.

Ruta tecnica

Publicacion path-first para connecthor.verserama.com.

En este repositorio la landing vive en /connecthor/. El subdominio connecthor.verserama.com requiere mapping externo de DNS/CDN o un despliegue dedicado que sirva esta ruta desde /.