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 OpenChamber 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 OpenChamber 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 OpenChamber 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 [email protected]: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 OpenChamber, 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 OpenChamber; el archivo original no se toca.

Repositorios privados e identidades Git

Las instalaciones SSH aceptan [email protected]:owner/extension.git y ssh://[email protected]/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 OpenChamber 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 OpenChamber. La extensión decide cuáles de ellos ofrece; todos están apagados hasta que permites la extensión.

Algunas extensiones muestran una imagen en vivo en lugar de un panel propio: aquello en lo que un agente está trabajando en el servidor, como un navegador o un simulador. Haz clic en la imagen o escribe para tomar el control; la línea de estado dirá Tienes el control y las acciones de navegador del agente se rechazarán hasta que pulses Devolver al agente. Copiar y pegar funcionan como siempre. Otro dispositivo conectado a la vez ve quién tiene el control y no puede quitarlo. Una extensión así puede añadir sus propios controles junto a la imagen, por ejemplo una barra de direcciones encima o una columna de herramientas al lado.

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 OpenChamber. 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 OpenChamber; 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.