Extensiones

Una extensión puede ofrecer una página a pantalla completa, como un tablero de tareas. Ábrela desde Páginas de extensiones, encima de las sesiones. El menú solo aparece para páginas habilitadas y aprobadas. Elegir un chat, recargar, pausar, eliminar o cambiar de servidor cierra la página. La extensión no puede abrirla por su cuenta.

Sus propios datos se guardan en el servidor conectado y se borran al eliminar la extensión. Un tablero puede seguir sesiones de varios proyectos y worktrees sin crear archivos en tu proyecto.

Usa Configuración → Extensiones para añadir a TokenWork paneles hechos por otras personas. Una extensión es una página pequeña que se coloca en la barra derecha, junto a los paneles integrados. Puede mostrarte datos de otro servicio, adjuntar una tarea al chat y, si se lo permites, iniciar sesiones, enviar prompts o leer archivos.

Las extensiones funcionan en TokenWork web y de escritorio. VS Code y la app móvil todavía no las cargan. No son lo mismo que los plugins de OpenCode.

Instalar una

Las extensiones marcadas como Integrada se incluyen con la instancia TokenWork seleccionada. Empiezan activadas y reciben sus permisos declarados sin otro diálogo. Usa Desactivar o Activar en su tarjeta. No se pueden eliminar ni actualizar por separado de la app. Desactivarlas conserva sus datos y cuentas conectadas, y esa elección se mantiene tras actualizar la app.

Sus cuentas aparecen en Ajustes → Integraciones → Integraciones nativas. Un servicio puede seguir necesitando un token API o iniciar sesión para acceder a tu cuenta.

1. Abre Configuración → Extensiones.
2. Pega una de estas opciones en el campo Carpeta, ZIP o URL y elige Añadir:
   • la ruta absoluta de una carpeta en este equipo
   • la ruta de un archivo .zip
   • un enlace https a un repositorio git o a un archivo zip
   • una dirección Git SSH como git@github.com:owner/extension.git
3. Si la extensión pide permisos, un diálogo los enumera. Elige Permitir y activar, o Eliminar para quitarla.

También puedes arrastrar un .zip sobre el campo o elegirlo con el botón de archivo que está al lado; el archivo se sube al servidor de TokenWork, así que esto también funciona con una instancia remota. En el escritorio, el botón de carpeta abre un selector nativo, y una carpeta arrastrada se instala desde su ruta.

El icono de la extensión aparece en la barra. Si no aparece, consulta Solución de problemas.

Una instalación desde carpeta se ejecuta directamente desde esa carpeta, así que quien desarrolla una extensión puede editar y recargar. Un zip o una URL se copia primero en la carpeta de datos de TokenWork; el archivo original no se toca.

Repositorios privados e identidades Git

Las instalaciones SSH aceptan git@github.com:owner/extension.git y ssh://git@github.com/owner/extension.git, con #branch-or-tag opcional. Elige la identidad global o una identidad Git guardada en el menú de huella junto al campo. La selección se conserva para comprobar e instalar actualizaciones; los cambios de clave se aplican en la siguiente operación.

La identidad global usa la configuración Git/SSH y el agente SSH del usuario que ejecuta el servidor TokenWork seleccionado. En una instancia remota, la clave debe estar disponible allí. Desbloquea primero las claves protegidas en el agente SSH de ese proceso. HTTPS usa las credenciales HTTPS de Git, sin cambiar automáticamente a SSH. Los hosts Git deben resolver a direcciones públicas; no se admiten alias SSH locales ni destinos de redes privadas.

Qué puede hacer una extensión

Mostrar un panel y leer qué proyecto y sesión están abiertos no necesita permiso. Todo lo que actúa en tu nombre sí lo necesita, y ves la lista completa una sola vez, al instalar:

• Enviar mensajes en tus sesiones: escribe y envía prompts al modelo, lo que gasta tokens y puede ejecutar herramientas.
• Acceder a proyectos y sesiones: listar proyectos, worktrees y estados de sesiones, y crear y abrir sesiones en proyectos registrados. El contenido de las conversaciones sigue siendo privado.
• Leer y escribir archivos del proyecto: cualquier archivo del proyecto abierto.
• Leer y escribir archivos fuera del proyecto: solo las ubicaciones enumeradas en el diálogo.
• Usar tu Small Model: generación de texto puntual fuera de tus sesiones, con el modelo de Configuración → Sesiones → Small Model. Gasta tokens.
• Conectarse a un servicio externo: con la cuenta que conectas en Configuración → Integraciones.
• Leer la conversación de una sesión: solo cuando ejecutas la acción de la extensión en esa sesión.
• Ejecutar un servicio local: un programa aparte con todo el acceso de tu usuario. Permítelo solo si confías en el autor.

Cuando una versión más nueva pide más de lo que permitiste, la tarjeta muestra Requiere aprobación y un botón Revisar permisos. Hasta que permitas la nueva lista, esa extensión sigue apagada.

Dónde aparece

Además de su panel en la barra lateral, una extensión puede añadir entradas a menús que ya usas: las acciones de un mensaje del chat, el menú de una sesión, el menú + junto al cuadro de chat y comandos de barra como /task ABC-12 que adjuntan algo sin abrir nada. También puede dar a sus propias herramientas un icono, un título y un diseño de salida propios en el chat, como los que tienen las herramientas integradas de TokenWork. La extensión decide cuáles de ellos ofrece; todos están apagados hasta que permites la extensión.

Conectar su cuenta

Una extensión que habla con un servicio recibe una tarjeta en Configuración → Integraciones bajo Cuentas de extensiones. Según el servicio, la tarjeta pide un token de API, un usuario y token, o un client id para un flujo de inicio de sesión. Elige Conectar; Desconectar olvida el token guardado. Los campos extra que declara la extensión se guardan solos al salir de ellos.

El token se queda en el servidor de TokenWork. La página de la extensión nunca lo ve.

Actualizar

Las extensiones instaladas desde una URL de git pueden actualizarse solas. Abrir Configuración → Extensiones comprueba cada una como máximo una vez por hora; Buscar actualizaciones comprueba al momento. Una tarjeta con una versión más nueva muestra Actualización disponible y un botón Actualizar. La actualización conserva tus permisos, cuentas y ajustes; si la nueva versión pide más, el diálogo de aprobación aparece otra vez. Las instalaciones por carpeta o zip no se actualizan: reemplázalas a mano.

Añade #v1.2.0 o #stable a la URL de git al instalar para seguir una etiqueta o rama en lugar de la rama por defecto.

Pausar o quitar

Cada tarjeta tiene un interruptor Activado. Apagado mantiene la extensión instalada pero oculta su panel y bloquea sus llamadas. Quitar borra una instalación por zip o URL de la carpeta de datos de TokenWork; en una instalación por carpeta solo olvida la ruta, tu carpeta se queda.

Crear la tuya

Todo lo que puede hacer una extensión, y cómo crear una, está en Crear una extensión.