O que uma extensão pode adicionar.
Uma extensão pode adicionar algo a quase todas as partes do OpenChamber, e parte do trabalho dela nem precisa de janela. Escolha um número para ver o que vai ali, como uma das nossas extensões usa e qual parte do SDK faz isso.
Escolha um número para ver o que vai ali.
1 Uma página em tela cheia Uma linha em Páginas abre a extensão em tela cheia, no lugar do chat.
2 Marcas nas linhas da barra lateral Um ícone pequeno nas sessões e worktrees que a extensão indica, com o texto dela na dica.
3 Um painel no trilho Um ícone no trilho da direita abre a página da extensão ao lado do chat.
4 Uma tela ao vivo O painel da extensão mostra uma imagem daquilo em que o agente trabalha, como um simulador de celular, e um clique na imagem tira o controle do agente.
5 Uma seção no Work Status Uma seção no painel ao lado do chat, com até quatro controles no cabeçalho.
6 Ferramentas no chat As chamadas às ferramentas da extensão ganham o ícone e o título dela, e a saída aparece como cartão, lista, tabela, JSON, Markdown ou código.
7 Blocos nas respostas do agente Os agentes podem escrever componentes da extensão numa resposta, e a página dela os desenha.
8 IDs que viram links Um ID de tarefa como UPL-31 numa mensagem, ou um link para o rastreador da extensão, fica clicável.
9 Avisos Uma mensagem curta no canto inferior direito da janela, por cima de tudo.
10 Um host Git ao lado do GitHub Um projeto cujo remoto está no host Git da extensão vê os merge requests e issues dele no quadro Issues e PRs, com os termos do próprio host.
11 Um rastreador ao lado do Linear As tarefas do rastreador da extensão ganham uma aba própria no quadro Issues e PRs, ao lado do Linear.
-
Uma linha em Páginas abre a extensão em tela cheia, no lugar do chat. O Acme Tasks mostra ali o quadro de tarefas.
UsaLer na documentaçãocontributes.page -
Um ícone pequeno nas sessões e worktrees que a extensão indica, com o texto dela na dica. O Acme CI põe um X vermelho em cada sessão de uma branch cujos checks falharam.
UsaLer na documentaçãocontributes.markshost.setMark() -
Um ícone no trilho da direita abre a página da extensão ao lado do chat. Um ponto no ícone diz que há algo esperando, e a dica mostra a quantidade.
UsaLer na documentaçãocontributes.panelhost.setBadge() -
O painel da extensão mostra uma imagem daquilo em que o agente trabalha, como um simulador de celular, e um clique na imagem tira o controle do agente. A extensão pode encaixar os próprios controles ao lado da imagem.
UsaLer a referência do SDKservice.surfacepanel.dock -
Uma seção no painel ao lado do chat, com até quatro controles no cabeçalho. O OpenChamber pode desenhar as linhas a partir do que o serviço da extensão responde, então a seção não precisa de página.
UsaLer na documentaçãocontributes.statusSectionhost.setStatusControls() -
As chamadas às ferramentas da extensão ganham o ícone e o título dela, e a saída aparece como cartão, lista, tabela, JSON, Markdown ou código. Bastam algumas linhas no manifesto, sem código.
UsaLer na documentaçãocontributes.tools -
Os agentes podem escrever componentes da extensão numa resposta, e a página dela os desenha. Um botão no bloco responde ao agente.
UsaLer na documentaçãocontributes.blockshost.answerBlock() -
Um ID de tarefa como UPL-31 numa mensagem, ou um link para o rastreador da extensão, fica clicável. Um clique abre a tarefa na extensão ou a anexa à mensagem.
UsaLer na documentaçãocontributes.links -
Uma mensagem curta no canto inferior direito da janela, por cima de tudo. Ela pode ter um botão Copiar para um erro ou um link, e ficar até o usuário fechar.
UsaLer na documentaçãohost.toast() -
Um projeto cujo remoto está no host Git da extensão vê os merge requests e issues dele no quadro Issues e PRs, com os termos do próprio host. Ali eles são revisados e mesclados, e de qualquer um começa um worktree ou uma sessão.
UsaLer na documentaçãoprovides: ["source-control"]contributes.sourceControl -
As tarefas do rastreador da extensão ganham uma aba própria no quadro Issues e PRs, ao lado do Linear. As mesmas tarefas aparecem no menu +, no New Worktree e nos itens vinculados de uma sessão.
UsaLer na documentaçãoprovides: ["tracker"]contributes.tracker
Uma página em tela cheia
Uma linha em Páginas abre a extensão em tela cheia, no lugar do chat. O Acme Tasks mostra ali o quadro de tarefas.
contributes.pageEscolha um número para ver o que vai ali.
1 Um item no menu + O item da extensão no menu + da caixa de chat abre o seletor dela numa janela.
2 Itens anexados Um item que a extensão anexa fica na caixa de chat como um chip, onde também chegam itens do GitHub e do Linear.
3 Comandos de barra /task UPL-31 anexa a tarefa sem abrir nada.
4 Linhas no menu @ O serviço da extensão responde ao que o usuário digita depois de @.
5 A paleta de comandos Ações de sessão e comandos de barra aparecem no ⌘P quando o usuário busca por eles ou pelo nome da extensão.
6 Logos de provedores Quando o plugin do OpenCode da extensão adiciona um provedor de modelos, o seletor de modelos e as Configurações mostram o provedor com o próprio logo.
-
O item da extensão no menu + da caixa de chat abre o seletor dela numa janela. O que o usuário escolhe vai para a mensagem como um chip.
UsaLer na documentaçãocontributes.attach -
Um item que a extensão anexa fica na caixa de chat como um chip, onde também chegam itens do GitHub e do Linear. O modelo lê o texto que vem junto, e um clique no chip abre o item na extensão.
UsaLer na documentaçãohost.attach() -
/task UPL-31 anexa a tarefa sem abrir nada. A extensão encontra a tarefa e a devolve como chip.
UsaLer na documentaçãocontributes.commandshost.onResolve() -
O serviço da extensão responde ao que o usuário digita depois de @. A linha escolhida vai para o agente como texto, e o usuário vê um chip.
UsaLer na documentaçãocontributes.mentions -
Ações de sessão e comandos de barra aparecem no ⌘P quando o usuário busca por eles ou pelo nome da extensão.
UsaLer na documentaçãocontributes.actionscontributes.commands -
Quando o plugin do OpenCode da extensão adiciona um provedor de modelos, o seletor de modelos e as Configurações mostram o provedor com o próprio logo.
UsaLer na documentaçãocontributes.providerLogos
Um item no menu +
O item da extensão no menu + da caixa de chat abre o seletor dela numa janela. O que o usuário escolhe vai para a mensagem como um chip.
contributes.attachEscolha um número para ver o que vai ali.
1 Um host Git A extensão adiciona um host Git ao lado de GitHub, GitLab e Gitea.
2 Um rastreador A extensão adiciona um rastreador ao lado do Linear.
3 Um canal de notificações O serviço da extensão recebe toda notificação que o celular receberia e a envia para um chat ou um servidor próprio.
4 Um cartão de conta Um cartão em Contas de extensões onde o usuário conecta o serviço com um token ou fazendo login.
5 Um provedor de uso Um cartão na página Uso ao lado dos provedores nativos, que também pode aparecer no Work Status.
6 O navegador do agente O serviço da extensão pode responder às ações de navegador do agente, então os agentes navegam sem o app de desktop aberto.
-
A extensão adiciona um host Git ao lado de GitHub, GitLab e Gitea. Um projeto nesse host ganha o quadro Issues e PRs, selos de pull request e worktrees a partir de pull requests.
UsaLer na documentaçãoprovides: ["source-control"]contributes.sourceControl -
A extensão adiciona um rastreador ao lado do Linear. As tarefas desse rastreador aparecem no seletor, no menu +, no New Worktree e nos itens vinculados de uma sessão.
UsaLer na documentaçãoprovides: ["tracker"]contributes.tracker -
O serviço da extensão recebe toda notificação que o celular receberia e a envia para um chat ou um servidor próprio. O token fica no OpenChamber.
UsaLer na documentaçãoprovides: ["notifications"]contributes.notifications -
Um cartão em Contas de extensões onde o usuário conecta o serviço com um token ou fazendo login. A extensão chama o serviço pelo OpenChamber e nunca vê o token.
UsaLer na documentaçãocontributes.integrationhost.request() -
Um cartão na página Uso ao lado dos provedores nativos, que também pode aparecer no Work Status. A extensão lê os números e o OpenChamber os desenha.
UsaLer na documentaçãoprovides: ["quota"]contributes.quota -
O serviço da extensão pode responder às ações de navegador do agente, então os agentes navegam sem o app de desktop aberto. O usuário escolhe esse serviço como provedor do navegador.
UsaLer na documentaçãoprovides: ["browser"]
Um host Git
A extensão adiciona um host Git ao lado de GitHub, GitLab e Gitea. Um projeto nesse host ganha o quadro Issues e PRs, selos de pull request e worktrees a partir de pull requests.
provides: ["source-control"]contributes.sourceControlEscolha um número para ver o que vai ali.
1 Blocos nas respostas do agente Os blocos que uma extensão adiciona às respostas do agente aparecem no celular na largura da resposta, sem nada a mais do autor.
2 IDs que viram links IDs de tarefa como UPL-31 nas mensagens do chat também viram links no celular, sem nada a mais do autor.
3 Ferramentas no chat As chamadas às ferramentas de uma extensão aparecem no celular com o ícone, o título e o layout de saída da extensão, sem nada a mais do autor.
4 Itens anexados Um item que uma extensão anexou fica na caixa de chat do celular como um chip, como no desktop.
5 Avisos Um aviso de uma extensão aparece no celular como um banner no topo da tela, com o botão "Copiar" incluído.
6 Uma aba do espaço de trabalho Com panel.mobile: true, o painel de uma extensão vira uma aba em tela cheia do espaço de trabalho do celular, depois das abas nativas.
7 Uma tela ao vivo Uma extensão com panel.mobile: true e uma imagem ao vivo mostra a imagem na aba do espaço de trabalho, com os controles do autor encaixados.
8 Uma seção em Status do trabalho A seção de Work Status de uma extensão aparece na aba "Status do trabalho" do espaço de trabalho, sem nada a mais do autor.
9 Popovers como folha inferior Um popover que uma extensão abre a partir de uma âncora aparece no celular como uma folha inferior com o nome da extensão no título, sem nada a mais do autor.
10 Uma página em tela cheia Uma página marcada com page: { entry, mobile: true } aparece em "Mais" na lista de sessões do celular e abre em tela cheia com uma seta de voltar.
11 Marcas nas linhas de sessões As marcas que uma extensão põe em sessões e worktrees aparecem na lista de sessões do celular, sem nada a mais do autor.
12 Ações no menu de toque longo de uma sessão Ações de sessão com mode: "background" ficam depois de "Arquivar" no menu que um toque longo numa linha de sessão abre.
13 Linhas de extensões na folha + Com panel.mobile: true, o item de anexar de uma extensão aparece na folha + da caixa de chat, abaixo dos seletores.
14 Um rastreador na folha + Um rastreador que uma extensão adiciona aparece na folha + da caixa de chat ao lado de GitHub e Linear, sem nada a mais do autor.
15 Comandos de barra Os comandos de barra de uma extensão funcionam na caixa de chat do celular, sem nada a mais do autor.
16 Linhas no menu @ As linhas que o serviço de uma extensão adiciona ao menu @ também aparecem no celular, sem nada a mais do autor.
17 Ações de mensagem Ações de mensagem com mode: "background" aparecem na folha "Mais ações" de uma mensagem no celular.
18 Ações no texto selecionado Ações de seleção com mode: "background" aparecem como botões na folha do texto selecionado no celular.
19 Um editor de arquivos O editor de uma extensão para um tipo de arquivo ocupa a aba "Arquivos" no celular, sem nada a mais do autor.
20 Ações no toque longo em Arquivos Ações de arquivo com mode: "background" ficam depois de "Copiar caminho" no menu que um toque longo numa linha de "Arquivos" abre.
21 Ações nas linhas selecionadas de um diff Ações de diff com mode: "background" aparecem no celular como botões com texto abaixo do campo de comentário das linhas selecionadas.
22 Logos de provedores O logo de provedor que uma extensão traz aparece no seletor de modelos do celular, sem nada a mais do autor.
23 Configurações → Extensões As configurações do celular têm uma página "Extensões" para adicionar, aprovar, pausar e remover extensões.
24 Cartões de conta Os cartões de rastreador, canal de notificações e conta de uma extensão aparecem em Configurações → Integrações no celular.
25 Um cartão de uso O provedor de uso de uma extensão ganha um cartão na página Configurações → Uso do celular, com o ícone da extensão, sem nada a mais do autor.
26 O navegador do agente Configurações → Ferramentas do OpenChamber no celular deixa escolher o serviço de uma extensão como navegador do agente.
-
Os blocos que uma extensão adiciona às respostas do agente aparecem no celular na largura da resposta, sem nada a mais do autor. Um toque num botão do bloco responde ao agente.
UsaLer na documentaçãocontributes.blocks -
IDs de tarefa como UPL-31 nas mensagens do chat também viram links no celular, sem nada a mais do autor. Um toque abre a aba da extensão no espaço de trabalho quando a extensão tem panel.mobile: true; sem isso, o link funciona como sempre.
UsaLer na documentaçãocontributes.links -
As chamadas às ferramentas de uma extensão aparecem no celular com o ícone, o título e o layout de saída da extensão, sem nada a mais do autor.
UsaLer na documentaçãocontributes.tools -
Um item que uma extensão anexou fica na caixa de chat do celular como um chip, como no desktop. Com panel.mobile: true um toque abre o item na aba da extensão; sem isso, um aviso diz que a extensão não abre no celular.
UsaLer na documentaçãohost.attach()panel.mobile: true -
Um aviso de uma extensão aparece no celular como um banner no topo da tela, com o botão "Copiar" incluído. O autor não faz mais nada.
UsaLer na documentaçãohost.toast() -
Com panel.mobile: true, o painel de uma extensão vira uma aba em tela cheia do espaço de trabalho do celular, depois das abas nativas. O contador do selo fica no ícone da aba, e Configurações → Geral ordena e oculta a aba junto com as outras.
UsaLer na documentaçãopanel.mobile: truehost.setBadge() -
Uma extensão com panel.mobile: true e uma imagem ao vivo mostra a imagem na aba do espaço de trabalho, com os controles do autor encaixados. O status diz "Toque para assumir o controle", e "Devolver ao agente" devolve o controle.
UsaLer a referência do SDKpanel.mobile: trueservice.surface -
A seção de Work Status de uma extensão aparece na aba "Status do trabalho" do espaço de trabalho, sem nada a mais do autor. Os controles crescem para 36 px para o dedo, e o seletor de seções a marca como "Extensão".
UsaLer na documentaçãocontributes.statusSection -
Um popover que uma extensão abre a partir de uma âncora aparece no celular como uma folha inferior com o nome da extensão no título, sem nada a mais do autor. A folha tem a altura que a extensão pediu e fecha com o X, um toque fora ou Voltar.
UsaLer a referência do SDKmountPopoverAnchor() -
Uma página marcada com page: { entry, mobile: true } aparece em "Mais" na lista de sessões do celular e abre em tela cheia com uma seta de voltar. Uma página com page: true reutiliza o HTML do painel, então segue panel.mobile.
UsaLer na documentaçãopage: { entry, mobile: true } -
As marcas que uma extensão põe em sessões e worktrees aparecem na lista de sessões do celular, sem nada a mais do autor. Um toque abre a aba da extensão quando ela tem panel.mobile: true; sem isso, mostra o texto da marca e abre o link dela, quando houver.
UsaLer na documentaçãocontributes.marks -
Ações de sessão com mode: "background" ficam depois de "Arquivar" no menu que um toque longo numa linha de sessão abre. Uma ação que abre o painel só aparece ali com panel.mobile: true.
UsaLer na documentaçãowhere: "session"mode: "background" -
Com panel.mobile: true, o item de anexar de uma extensão aparece na folha + da caixa de chat, abaixo dos seletores. Um diálogo abre em tela cheia, e um painel abre como a aba da extensão.
UsaLer na documentaçãocontributes.attachpanel.mobile: true -
Um rastreador que uma extensão adiciona aparece na folha + da caixa de chat ao lado de GitHub e Linear, sem nada a mais do autor.
UsaLer na documentaçãoprovides: ["tracker"] -
Os comandos de barra de uma extensão funcionam na caixa de chat do celular, sem nada a mais do autor. Um comando que abre o painel precisa de panel.mobile: true.
UsaLer na documentaçãocontributes.commands -
As linhas que o serviço de uma extensão adiciona ao menu @ também aparecem no celular, sem nada a mais do autor.
UsaLer na documentaçãocontributes.mentions -
Ações de mensagem com mode: "background" aparecem na folha "Mais ações" de uma mensagem no celular. Uma ação que abre o painel só aparece ali com panel.mobile: true.
UsaLer na documentaçãowhere: "message"mode: "background" -
Ações de seleção com mode: "background" aparecem como botões na folha do texto selecionado no celular. Uma ação que abre o painel só aparece ali com panel.mobile: true.
UsaLer na documentaçãowhere: "selection"mode: "background" -
O editor de uma extensão para um tipo de arquivo ocupa a aba "Arquivos" no celular, sem nada a mais do autor. O OpenChamber guarda e salva o arquivo, como no desktop.
UsaLer na documentaçãocontributes.fileEditors -
Ações de arquivo com mode: "background" ficam depois de "Copiar caminho" no menu que um toque longo numa linha de "Arquivos" abre. Uma ação que abre o painel só aparece ali com panel.mobile: true.
UsaLer na documentaçãowhere: "file"mode: "background" -
Ações de diff com mode: "background" aparecem no celular como botões com texto abaixo do campo de comentário das linhas selecionadas. Uma ação que abre o painel só aparece ali com panel.mobile: true.
UsaLer na documentaçãowhere: "diff"mode: "background" -
O logo de provedor que uma extensão traz aparece no seletor de modelos do celular, sem nada a mais do autor.
UsaLer na documentaçãocontributes.providerLogos -
As configurações do celular têm uma página "Extensões" para adicionar, aprovar, pausar e remover extensões. As permissões abrem numa folha inferior, e o autor não faz nada para isso.
Ler na documentação -
Os cartões de rastreador, canal de notificações e conta de uma extensão aparecem em Configurações → Integrações no celular. Ali a conta se conecta com um token.
UsaLer na documentaçãocontributes.integration -
O provedor de uso de uma extensão ganha um cartão na página Configurações → Uso do celular, com o ícone da extensão, sem nada a mais do autor.
UsaLer na documentaçãoprovides: ["quota"] -
Configurações → Ferramentas do OpenChamber no celular deixa escolher o serviço de uma extensão como navegador do agente.
UsaLer na documentaçãoprovides: ["browser"]
Blocos nas respostas do agente
Os blocos que uma extensão adiciona às respostas do agente aparecem no celular na largura da resposta, sem nada a mais do autor. Um toque num botão do bloco responde ao agente.
contributes.blocksTrabalho sem nenhuma janela aberta
Um serviço local roda ao lado do OpenChamber e continua trabalhando enquanto ninguém olha.
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"] Comece a construir
Uma extensão é uma pasta com um manifesto e uma página web. "Crie uma extensão" explica as duas coisas e como instalá-la da pasta enquanto você trabalha nela. A página Exemplo tem uma extensão completa para copiar.