Qué puede añadir una extensión.
Una extensión puede añadir algo a casi cualquier parte de OpenChamber, y parte de su trabajo no necesita ninguna ventana. Elige un número para ver qué va ahí, cómo lo usa una de nuestras extensiones y qué parte del SDK lo hace.
Elige un número para ver qué va ahí.
1 Una página a pantalla completa Una fila en Páginas abre la extensión a pantalla completa, en lugar del chat.
2 Marcas en las filas de la barra lateral Un icono pequeño en las sesiones y los worktrees que nombra la extensión, con su texto en el tooltip.
3 Un panel en el riel Un icono en el riel derecho abre la página de la extensión junto al chat.
4 Una pantalla en vivo El panel de la extensión muestra una imagen de aquello en lo que trabaja el agente, como un simulador de teléfono, y un clic en la imagen le quita el control al agente.
5 Una sección en Work Status Una sección en el panel junto al chat, con hasta cuatro controles en su cabecera.
6 Herramientas en el chat Las llamadas a las herramientas de la extensión llevan su icono y su título, y la salida se muestra como tarjeta, lista, tabla, JSON, Markdown o código.
7 Bloques en las respuestas del agente Los agentes pueden escribir componentes de la extensión en una respuesta, y su página los dibuja.
8 ID que se vuelven enlaces Un ID de tarea como UPL-31 en un mensaje, o un enlace al gestor de tareas de la extensión, se vuelve clicable.
9 Avisos Un mensaje corto en la esquina inferior derecha de la ventana, por encima de todo.
10 Un host de Git junto a GitHub Un proyecto cuyo remoto está en el host de Git de la extensión ve sus merge requests e issues en el tablero Issues y PR, con los términos del propio host.
11 Un gestor de tareas junto a Linear Las tareas del gestor de la extensión tienen su propia pestaña en el tablero Issues y PR, junto a Linear.
-
Una fila en Páginas abre la extensión a pantalla completa, en lugar del chat. Acme Tasks muestra ahí su tablero de tareas.
UsaLeer en la documentacióncontributes.page -
Un icono pequeño en las sesiones y los worktrees que nombra la extensión, con su texto en el tooltip. Acme CI pone una cruz roja en cada sesión de una rama cuyos checks fallaron.
UsaLeer en la documentacióncontributes.markshost.setMark() -
Un icono en el riel derecho abre la página de la extensión junto al chat. Un punto en el icono indica que algo espera, y el tooltip da la cantidad.
UsaLeer en la documentacióncontributes.panelhost.setBadge() -
El panel de la extensión muestra una imagen de aquello en lo que trabaja el agente, como un simulador de teléfono, y un clic en la imagen le quita el control al agente. La extensión puede acoplar sus propios controles junto a la imagen.
UsaLeer la referencia del SDKservice.surfacepanel.dock -
Una sección en el panel junto al chat, con hasta cuatro controles en su cabecera. OpenChamber puede dibujar las filas a partir de lo que responde el servicio de la extensión, así que la sección no necesita página.
UsaLeer en la documentacióncontributes.statusSectionhost.setStatusControls() -
Las llamadas a las herramientas de la extensión llevan su icono y su título, y la salida se muestra como tarjeta, lista, tabla, JSON, Markdown o código. Bastan unas líneas en el manifiesto, sin código.
UsaLeer en la documentacióncontributes.tools -
Los agentes pueden escribir componentes de la extensión en una respuesta, y su página los dibuja. Un botón del bloque responde al agente.
UsaLeer en la documentacióncontributes.blockshost.answerBlock() -
Un ID de tarea como UPL-31 en un mensaje, o un enlace al gestor de tareas de la extensión, se vuelve clicable. Un clic abre la tarea en la extensión o la adjunta al mensaje.
UsaLeer en la documentacióncontributes.links -
Un mensaje corto en la esquina inferior derecha de la ventana, por encima de todo. Puede llevar un botón Copiar para un error o un enlace, y quedarse hasta que el usuario lo cierre.
UsaLeer en la documentaciónhost.toast() -
Un proyecto cuyo remoto está en el host de Git de la extensión ve sus merge requests e issues en el tablero Issues y PR, con los términos del propio host. Ahí se revisan y se fusionan, y desde cualquiera empieza un worktree o una sesión.
UsaLeer en la documentaciónprovides: ["source-control"]contributes.sourceControl -
Las tareas del gestor de la extensión tienen su propia pestaña en el tablero Issues y PR, junto a Linear. Las mismas tareas aparecen en el menú +, en New Worktree y entre los elementos vinculados de una sesión.
UsaLeer en la documentaciónprovides: ["tracker"]contributes.tracker
Una página a pantalla completa
Una fila en Páginas abre la extensión a pantalla completa, en lugar del chat. Acme Tasks muestra ahí su tablero de tareas.
contributes.pageElige un número para ver qué va ahí.
1 Una entrada en el menú + La entrada de la extensión en el menú + del cuadro de chat abre su selector en una ventana.
2 Elementos adjuntos Un elemento que adjunta la extensión queda como chip en el cuadro de chat, donde también llegan los elementos de GitHub y Linear.
3 Comandos con barra /task UPL-31 adjunta la tarea sin abrir nada.
4 Filas en el menú @ El servicio de la extensión responde a lo que el usuario escribe tras @.
5 La paleta de comandos Las acciones de sesión y los comandos con barra aparecen en ⌘P cuando el usuario los busca o busca el nombre de la extensión.
6 Logos de proveedores Cuando el plugin de OpenCode de la extensión añade un proveedor de modelos, el selector de modelos y Ajustes lo muestran con su propio logo.
-
La entrada de la extensión en el menú + del cuadro de chat abre su selector en una ventana. Lo que el usuario elige llega al mensaje como chip.
UsaLeer en la documentacióncontributes.attach -
Un elemento que adjunta la extensión queda como chip en el cuadro de chat, donde también llegan los elementos de GitHub y Linear. El modelo lee el texto que lo acompaña, y un clic en el chip abre el elemento en la extensión.
UsaLeer en la documentaciónhost.attach() -
/task UPL-31 adjunta la tarea sin abrir nada. La extensión busca la tarea y la devuelve como chip.
UsaLeer en la documentacióncontributes.commandshost.onResolve() -
El servicio de la extensión responde a lo que el usuario escribe tras @. La fila elegida llega al agente como texto, y el usuario ve un chip.
UsaLeer en la documentacióncontributes.mentions -
Las acciones de sesión y los comandos con barra aparecen en ⌘P cuando el usuario los busca o busca el nombre de la extensión.
UsaLeer en la documentacióncontributes.actionscontributes.commands -
Cuando el plugin de OpenCode de la extensión añade un proveedor de modelos, el selector de modelos y Ajustes lo muestran con su propio logo.
UsaLeer en la documentacióncontributes.providerLogos
Una entrada en el menú +
La entrada de la extensión en el menú + del cuadro de chat abre su selector en una ventana. Lo que el usuario elige llega al mensaje como chip.
contributes.attachElige un número para ver qué va ahí.
1 Un host de Git La extensión añade un host de Git junto a GitHub, GitLab y Gitea.
2 Un gestor de tareas La extensión añade un gestor de tareas junto a Linear.
3 Un canal de notificaciones El servicio de la extensión recibe cada notificación que recibiría el teléfono y la envía a un chat o a un servidor propio.
4 Una tarjeta de cuenta Una tarjeta en Cuentas de extensiones donde el usuario conecta el servicio con un token o iniciando sesión.
5 Un proveedor de uso Una tarjeta en la página Uso junto a los proveedores integrados, que también puede mostrarse en Work Status.
6 El navegador del agente El servicio de la extensión puede responder a las acciones de navegador del agente, así los agentes navegan sin la app de escritorio abierta.
-
La extensión añade un host de Git junto a GitHub, GitLab y Gitea. Un proyecto alojado en ese host tiene el tablero Issues y PR, insignias de pull request y worktrees creados desde pull requests.
UsaLeer en la documentaciónprovides: ["source-control"]contributes.sourceControl -
La extensión añade un gestor de tareas junto a Linear. Las tareas de ese gestor aparecen en el selector, el menú +, New Worktree y los elementos vinculados de una sesión.
UsaLeer en la documentaciónprovides: ["tracker"]contributes.tracker -
El servicio de la extensión recibe cada notificación que recibiría el teléfono y la envía a un chat o a un servidor propio. El token se queda en OpenChamber.
UsaLeer en la documentaciónprovides: ["notifications"]contributes.notifications -
Una tarjeta en Cuentas de extensiones donde el usuario conecta el servicio con un token o iniciando sesión. La extensión llama al servicio a través de OpenChamber y nunca ve el token.
UsaLeer en la documentacióncontributes.integrationhost.request() -
Una tarjeta en la página Uso junto a los proveedores integrados, que también puede mostrarse en Work Status. La extensión lee las cifras y OpenChamber las dibuja.
UsaLeer en la documentaciónprovides: ["quota"]contributes.quota -
El servicio de la extensión puede responder a las acciones de navegador del agente, así los agentes navegan sin la app de escritorio abierta. El usuario elige ese servicio como proveedor del navegador.
UsaLeer en la documentaciónprovides: ["browser"]
Un host de Git
La extensión añade un host de Git junto a GitHub, GitLab y Gitea. Un proyecto alojado en ese host tiene el tablero Issues y PR, insignias de pull request y worktrees creados desde pull requests.
provides: ["source-control"]contributes.sourceControlElige un número para ver qué va ahí.
1 Bloques en las respuestas del agente Los bloques que una extensión añade a las respuestas del agente aparecen en el teléfono al ancho de la respuesta, sin que el autor haga nada más.
2 ID que se vuelven enlaces Los ID de tarea como UPL-31 en los mensajes del chat también se vuelven enlaces en el teléfono, sin que el autor haga nada más.
3 Herramientas en el chat Las llamadas a las herramientas de una extensión aparecen en el teléfono con el icono, el título y el diseño de salida de la extensión, sin que el autor haga nada más.
4 Elementos adjuntos Un elemento que adjuntó una extensión queda como chip en el cuadro de chat del teléfono, igual que en el escritorio.
5 Avisos Un aviso de una extensión aparece en el teléfono como un banner arriba de la pantalla, con el botón "Copiar" incluido.
6 Una pestaña del espacio de trabajo Con panel.mobile: true, el panel de una extensión se convierte en una pestaña a pantalla completa del espacio de trabajo del teléfono, después de las pestañas integradas.
7 Una pantalla en vivo Una extensión con panel.mobile: true y una imagen en vivo muestra la imagen en su pestaña del espacio de trabajo, con los controles propios del autor acoplados.
8 Una sección en Estado del trabajo La sección de Work Status de una extensión aparece en la pestaña "Estado del trabajo" del espacio de trabajo, sin que el autor haga nada más.
9 Popovers como hoja inferior Un popover que una extensión abre desde un ancla aparece en el teléfono como una hoja inferior titulada con el nombre de la extensión, sin que el autor haga nada más.
10 Una página a pantalla completa Una página marcada con page: { entry, mobile: true } aparece en "Más" en la lista de sesiones del teléfono y se abre a pantalla completa con una flecha atrás.
11 Marcas en las filas de sesiones Las marcas que una extensión pone en sesiones y worktrees aparecen en la lista de sesiones del teléfono, sin que el autor haga nada más.
12 Acciones del menú de pulsación larga de una sesión Las acciones de sesión con mode: "background" aparecen después de "Archivar" en el menú que abre una pulsación larga sobre una fila de sesión.
13 Filas de extensiones en la hoja + Con panel.mobile: true, la entrada para adjuntar de una extensión aparece en la hoja + del cuadro de chat, debajo de los selectores.
14 Un gestor de tareas en la hoja + Un gestor de tareas que añade una extensión aparece en la hoja + del cuadro de chat junto a GitHub y Linear, sin que el autor haga nada más.
15 Comandos con barra Los comandos con barra de una extensión funcionan en el cuadro de chat del teléfono, sin que el autor haga nada más.
16 Filas en el menú @ Las filas que el servicio de una extensión añade al menú @ también aparecen en el teléfono, sin que el autor haga nada más.
17 Acciones de mensaje Las acciones de mensaje con mode: "background" aparecen en la hoja "Más acciones" de un mensaje en el teléfono.
18 Acciones sobre el texto seleccionado Las acciones de selección con mode: "background" aparecen como botones en la hoja del texto seleccionado del teléfono.
19 Un editor de archivos El editor de una extensión para un tipo de archivo ocupa la pestaña "Archivos" en el teléfono, sin que el autor haga nada más.
20 Acciones con pulsación larga en Archivos Las acciones de archivo con mode: "background" aparecen después de "Copiar ruta" en el menú que abre una pulsación larga sobre una fila de "Archivos".
21 Acciones sobre líneas seleccionadas de un diff Las acciones de diff con mode: "background" aparecen en el teléfono como botones con texto debajo del campo de comentario de las líneas seleccionadas.
22 Logos de proveedores El logo de proveedor que incluye una extensión aparece en el selector de modelos del teléfono, sin que el autor haga nada más.
23 Configuración → Extensiones Los ajustes del teléfono tienen una página "Extensiones" para añadir, aprobar, pausar y quitar extensiones.
24 Tarjetas de cuenta Las tarjetas del gestor de tareas, del canal de notificaciones y de la cuenta de una extensión aparecen en Configuración → Integraciones en el teléfono.
25 Una tarjeta de uso El proveedor de uso de una extensión tiene una tarjeta en la página Configuración → Uso del teléfono, con el icono de la extensión, sin que el autor haga nada más.
26 El navegador del agente Configuración → Herramientas de OpenChamber en el teléfono permite elegir el servicio de una extensión como navegador del agente.
-
Los bloques que una extensión añade a las respuestas del agente aparecen en el teléfono al ancho de la respuesta, sin que el autor haga nada más. Tocar un botón del bloque responde al agente.
UsaLeer en la documentacióncontributes.blocks -
Los ID de tarea como UPL-31 en los mensajes del chat también se vuelven enlaces en el teléfono, sin que el autor haga nada más. Un toque abre la pestaña de la extensión en el espacio de trabajo cuando la extensión tiene panel.mobile: true; si no, el enlace funciona como siempre.
UsaLeer en la documentacióncontributes.links -
Las llamadas a las herramientas de una extensión aparecen en el teléfono con el icono, el título y el diseño de salida de la extensión, sin que el autor haga nada más.
UsaLeer en la documentacióncontributes.tools -
Un elemento que adjuntó una extensión queda como chip en el cuadro de chat del teléfono, igual que en el escritorio. Con panel.mobile: true un toque lo abre en la pestaña de la extensión; sin él, un aviso dice que la extensión no se abre en el teléfono.
UsaLeer en la documentaciónhost.attach()panel.mobile: true -
Un aviso de una extensión aparece en el teléfono como un banner arriba de la pantalla, con el botón "Copiar" incluido. El autor no hace nada más.
UsaLeer en la documentaciónhost.toast() -
Con panel.mobile: true, el panel de una extensión se convierte en una pestaña a pantalla completa del espacio de trabajo del teléfono, después de las pestañas integradas. El contador del indicador va en el icono de la pestaña, y Configuración → General la ordena y la oculta junto con las demás.
UsaLeer en la documentaciónpanel.mobile: truehost.setBadge() -
Una extensión con panel.mobile: true y una imagen en vivo muestra la imagen en su pestaña del espacio de trabajo, con los controles propios del autor acoplados. El estado dice "Toca para tomar el control", y "Devolver al agente" devuelve el control.
UsaLeer la referencia del SDKpanel.mobile: trueservice.surface -
La sección de Work Status de una extensión aparece en la pestaña "Estado del trabajo" del espacio de trabajo, sin que el autor haga nada más. Sus controles crecen a 36 px para el dedo, y el selector de secciones la marca como "Extensión".
UsaLeer en la documentacióncontributes.statusSection -
Un popover que una extensión abre desde un ancla aparece en el teléfono como una hoja inferior titulada con el nombre de la extensión, sin que el autor haga nada más. La hoja tiene la altura que pidió la extensión y se cierra con la cruz, tocando fuera o con Atrás.
UsaLeer la referencia del SDKmountPopoverAnchor() -
Una página marcada con page: { entry, mobile: true } aparece en "Más" en la lista de sesiones del teléfono y se abre a pantalla completa con una flecha atrás. Una página con page: true reutiliza el HTML del panel, así que sigue a panel.mobile.
UsaLeer en la documentaciónpage: { entry, mobile: true } -
Las marcas que una extensión pone en sesiones y worktrees aparecen en la lista de sesiones del teléfono, sin que el autor haga nada más. Un toque abre la pestaña de la extensión cuando tiene panel.mobile: true; si no, muestra el texto de la marca y abre su enlace, si lo tiene.
UsaLeer en la documentacióncontributes.marks -
Las acciones de sesión con mode: "background" aparecen después de "Archivar" en el menú que abre una pulsación larga sobre una fila de sesión. Una acción que abre el panel aparece ahí solo con panel.mobile: true.
UsaLeer en la documentaciónwhere: "session"mode: "background" -
Con panel.mobile: true, la entrada para adjuntar de una extensión aparece en la hoja + del cuadro de chat, debajo de los selectores. Un diálogo se abre a pantalla completa, y un panel se abre como la pestaña de la extensión.
UsaLeer en la documentacióncontributes.attachpanel.mobile: true -
Un gestor de tareas que añade una extensión aparece en la hoja + del cuadro de chat junto a GitHub y Linear, sin que el autor haga nada más.
UsaLeer en la documentaciónprovides: ["tracker"] -
Los comandos con barra de una extensión funcionan en el cuadro de chat del teléfono, sin que el autor haga nada más. Un comando que abre el panel necesita panel.mobile: true.
UsaLeer en la documentacióncontributes.commands -
Las filas que el servicio de una extensión añade al menú @ también aparecen en el teléfono, sin que el autor haga nada más.
UsaLeer en la documentacióncontributes.mentions -
Las acciones de mensaje con mode: "background" aparecen en la hoja "Más acciones" de un mensaje en el teléfono. Una acción que abre el panel aparece ahí solo con panel.mobile: true.
UsaLeer en la documentaciónwhere: "message"mode: "background" -
Las acciones de selección con mode: "background" aparecen como botones en la hoja del texto seleccionado del teléfono. Una acción que abre el panel aparece ahí solo con panel.mobile: true.
UsaLeer en la documentaciónwhere: "selection"mode: "background" -
El editor de una extensión para un tipo de archivo ocupa la pestaña "Archivos" en el teléfono, sin que el autor haga nada más. OpenChamber conserva y guarda el archivo, igual que en el escritorio.
UsaLeer en la documentacióncontributes.fileEditors -
Las acciones de archivo con mode: "background" aparecen después de "Copiar ruta" en el menú que abre una pulsación larga sobre una fila de "Archivos". Una acción que abre el panel aparece ahí solo con panel.mobile: true.
UsaLeer en la documentaciónwhere: "file"mode: "background" -
Las acciones de diff con mode: "background" aparecen en el teléfono como botones con texto debajo del campo de comentario de las líneas seleccionadas. Una acción que abre el panel aparece ahí solo con panel.mobile: true.
UsaLeer en la documentaciónwhere: "diff"mode: "background" -
El logo de proveedor que incluye una extensión aparece en el selector de modelos del teléfono, sin que el autor haga nada más.
UsaLeer en la documentacióncontributes.providerLogos -
Los ajustes del teléfono tienen una página "Extensiones" para añadir, aprobar, pausar y quitar extensiones. Los permisos se abren en una hoja inferior, y el autor no hace nada para ello.
Leer en la documentación -
Las tarjetas del gestor de tareas, del canal de notificaciones y de la cuenta de una extensión aparecen en Configuración → Integraciones en el teléfono. Ahí la cuenta se conecta con un token.
UsaLeer en la documentacióncontributes.integration -
El proveedor de uso de una extensión tiene una tarjeta en la página Configuración → Uso del teléfono, con el icono de la extensión, sin que el autor haga nada más.
UsaLeer en la documentaciónprovides: ["quota"] -
Configuración → Herramientas de OpenChamber en el teléfono permite elegir el servicio de una extensión como navegador del agente.
UsaLeer en la documentaciónprovides: ["browser"]
Bloques en las respuestas del agente
Los bloques que una extensión añade a las respuestas del agente aparecen en el teléfono al ancho de la respuesta, sin que el autor haga nada más. Tocar un botón del bloque responde al agente.
contributes.blocksTrabajo sin ninguna ventana abierta
Un servicio local se ejecuta junto a OpenChamber y sigue trabajando aunque nadie mire.
service.keepRunningservice.schedule contributes.sessionEvents contributes.sessionControl contributes.instructionscontributes.skills contributes.opencodePlugin contributes.waits host.generate() host.readFile()contributes.filesystem host.storage host.onRunningShells() provides: ["opencode"] Empieza a construir
Una extensión es una carpeta con un manifiesto y una página web. "Crea una extensión" explica ambas cosas y cómo instalarla desde la carpeta mientras trabajas en ella. La página Ejemplo tiene una extensión completa para copiar.