Workspaces e chats remotos
O Maestrly pode rodar seus chats e workspaces no seu servidor de bots em vez de neste computador. Eles continuam trabalhando com este computador em repouso ou desligado, e você os usa na mesma janela: a barra lateral mostra lado a lado os chats e workspaces deste computador e os do servidor.
Experimental: os workspaces remotos exigem o Maestrly 0.16.0 ou mais recente, no app desktop e no servidor.
Como funciona
O servidor roda mais um Maestrly, num contêiner só dele, para os seus chats e workspaces. Esse contêiner é o ambiente de workspaces. Ele não tem bots: bots e workspaces podem dividir um servidor, mas nunca um contêiner.
| No servidor | Neste computador |
|---|---|
| As conversas, suas mensagens e os turnos do agente, incluindo Maestro, subagentes, planos e revisões | A janela: barra lateral, chat, gaveta e configurações |
| Os workspaces, seus repositórios Git, worktrees e terminais | Sons, atalhos de teclado, layout da janela e atualizações deste app |
| Contas de modelo, skills, servidores MCP e memória do perfil do próprio servidor | Os chats, workspaces, contas e configurações deste computador, sem mudança |
| O navegador do agente, com cookies e logins em sites | O microfone e a transcrição de voz |
| O VS Code da aba Código, com suas extensões | As suas configurações do editor, aplicadas ao editor do servidor |
Um turno rodando no servidor continua quando este computador entra em repouso, perde a conexão ou fecha o app. Quando você volta, a conversa mostra o que aconteceu nesse meio-tempo.
Configurar
- Configure um servidor de bots e conecte este computador a ele. Veja Bots e servidor de bots. É um servidor numa VPS que continua trabalhando com este computador desligado.
- Abra a aba Bots, selecione o servidor e, em Workspaces, escolha Configurar workspaces neste servidor. Um servidor hospeda workspaces num único ambiente; use outro servidor para manter trabalhos separados.
- Na página do ambiente, adicione as contas de modelo que ele vai usar: uma chave de API, o login de uma assinatura ou contas trazidas deste computador. Ele começa sem contas, skills ou servidores MCP próprios, e nada é copiado deste computador sem você pedir.
Quando ele estiver rodando, as abas Chats e Workspaces mostram duas seções: Este computador e o nome do servidor. Se Workspaces disser Atualize o servidor para rodar workspaces nele., use Atualizar bots primeiro.
Usar
- Novo chat no servidor: use o + no título do servidor na aba Chats. O botão Novo chat do cabeçalho continua criando um chat neste computador.
- Adicionar um workspace no servidor: use o + no título do servidor na aba Workspaces e abra uma pasta que já está no servidor, crie um projeto ou clone um repositório Git. As pastas são escolhidas numa janela que navega pelo servidor. O clone usa as credenciais Git do ambiente do servidor, não as deste computador.
- Gaveta: uma conversa no servidor oferece Navegador, Código, Terminal, Arquivos, Plano, Review e Notas, todos rodando no servidor.
- Configurações: em Configurações, as seções que pertencem a um perfil, como Maestrly Chat, Uso e custos e Execução, ganham o seletor Configurações de. Escolha o servidor ali para mudar as contas, modelos, skills e padrões dele.
- Memória: os chats no servidor usam a memória pessoal do servidor, e os workspaces dele guardam a própria memória do projeto lá; nada é compartilhado com este computador. O painel de memória pessoal tem o seletor Memórias de.
- Iniciar, parar, reiniciar, atualizar e arquivar: na página do ambiente, aberta por Gerenciar em Workspaces ou por Abrir página do servidor no menu do título do servidor. Parar, reiniciar ou atualizar na hora interrompe os chats que estão rodando no servidor.
Onde ficam os arquivos
| Servidor | Pastas oferecidas ao adicionar um workspace |
|---|---|
| Uma VPS configurada pelo Maestrly | Workspaces (/srv/maestrly, uma pasta do próprio servidor) e Pasta pessoal (a pasta pessoal do ambiente) |
| Docker neste computador | Só Pasta pessoal; nenhuma pasta deste computador é montada |
| Um servidor que você administra | Workspaces quando você define MAESTRLY_GATEWAY_WORKSPACES_ROOT, e Pasta pessoal |
Prefira Workspaces para projetos: os arquivos são arquivos comuns do servidor, então você pode acessá-los por SSH, fazer backup e mantê-los quando o ambiente for arquivado.
Navegador, Código e Arquivos
- Navegador mostra ao vivo o navegador do agente no servidor, com os cookies e logins do servidor. Você pode clicar, rolar, digitar e usar as abas e a barra de endereço; acentos, métodos de entrada e copiar e colar funcionam como neste computador. Quando outro computador abre o mesmo navegador, este mostra Este navegador está aberto em outro dispositivo., com Mostrar aqui para trazê-lo de volta.
- Código abre o VS Code no servidor, na pasta da conversa; o terminal, o Git, as extensões e o depurador dele funcionam no servidor. O servidor baixa o VS Code da Microsoft na primeira vez, o que pode levar um minuto. As suas configurações e o tema do VS Code são aplicados na primeira abertura; as extensões são instaladas no editor do servidor.
- Arquivos navega pelas pastas do servidor, mostra uma prévia, renomeia e apaga arquivos, e os transfere entre o servidor e este computador. Use Enviar… ou arraste arquivos para a aba; os downloads vão para a sua pasta Downloads, e Abrir neste computador abre um arquivo com o app padrão. Transferências mostra o progresso e permite pausar, retomar e tentar de novo. As transferências sobrevivem a repouso, quedas de conexão e reinícios, e cada arquivo é conferido com SHA-256. Pastas não são transferidas inteiras: compacte antes ou use o Git.
Estados da conexão
O título do servidor mostra como este computador o alcança:
| Estado | O que fazer |
|---|---|
| Sem rótulo | Conectado. |
| Conectando… ou Reconectando… | Aguarde. O trabalho no servidor continua, e a seção mantém a última lista. |
| Atualização necessária | O servidor e este app estão em versões diferentes. Use Atualizar bots ou atualize o app. |
| Parado, Iniciando… ou Falha ao iniciar | Use Iniciar no ambiente de workspaces ou abra a página do servidor para ver detalhes. |
| Sem conexão | Verifique o servidor em Configurações → Servidor de bots. |
Mensagens na fila atrás de um turno em andamento ficam só nesta janela e se perdem se a conexão cair antes de serem enviadas. Dois computadores pareados com o mesmo servidor veem os mesmos chats e workspaces, e qualquer um deles pode responder a um pedido de permissão, uma pergunta ou um plano.
Ainda não disponível
- Transferir pastas inteiras em Arquivos, o som das páginas, enviar arquivos por uma página e baixar arquivos pelo navegador remoto.
- Sons de alerta, janelas flutuantes da gaveta, sessões do ChatGPT Web Companion, revisões pareadas entre duas conversas e grupos de workspaces, nas conversas do servidor.
- Mais de um servidor: este computador se pareia com um único servidor de bots.
- Isolamento entre os workspaces de um servidor: eles dividem um contêiner, um usuário e um conjunto de contas.
Segurança e limites
- Parear um computador com o servidor de bots já permite que ele controle todos os ambientes do servidor. No ambiente de workspaces, isso é tudo o que o Maestrly faz no próprio computador: ler e gravar arquivos, rodar comandos e usar as contas.
- O servidor e quem o administra alcançam seus projetos e contas remotos. Trate o servidor como trataria o seu próprio computador.
- O servidor e o app precisam estar na mesma versão. Faça backup do volume do gateway antes de atualizar o servidor: a 0.16.0 muda o banco de dados dele, e servidores mais antigos não conseguem abri-lo.
- O uso de modelos no servidor é cobrado nas contas que você adiciona ao ambiente dele.
Para resolver problemas e ver detalhes, leia o guia técnico completo (em inglês).
A seguir: Artefatos.