Um só Core. Tu escolhes onde tudo corre.

O devctrl tem três partes: o Core, que é o controlador e o gateway da consola; os hosts, que executam os espaços de trabalho dos agentes; e as consolas a partir das quais te ligas. Coloca cada parte onde te for mais conveniente. Cada cartão mostra o que corre onde e as funções que o tornam possível.

SOZINHO · UM PORTÁTIL

Tudo num portátil

Para experimentar o devctrl ou trabalhar sozinho, sem servidor para configurar.

Um terminal ou navegador no teu portátil fala com o Core por localhost, e o Core inicia contentores de agentes no Docker local do portátil.O TEU PORTÁTILTerminal ounavegadorTUIConsola webCoreControlador e gatewaywebDocker localClaude CodeCodexlocalhostDocker APIUm terminal ou navegador no teu portátil fala com o Core por localhost, e o Core inicia contentores de agentes no Docker local do portátil.O TEU PORTÁTILTerminal ou navegadorTUIConsola webCoreControlador e gateway webDocker localClaude CodeCodexlocalhostDocker API
  • Sem argumentos, o instalador usa o modo Local Docker. Não são precisos SSH nem um servidor remoto; --docker-context escolhe outro contexto do Docker.
  • devctrl local tui e devctrl local web abrem as consolas de terminal e de navegador.
SOZINHO · UM SERVIDOR

Um servidor para todas as tuas sessões

Para quem quer que os agentes continuem a trabalhar com o portátil fechado.

Um terminal chega ao Core no teu servidor por SSH, um navegador ou a aplicação de secretária por um WebSocket cifrado, e Android ou Telegram por HTTPS; o Core executa os contentores dos agentes no mesmo servidor, opcionalmente com uma GPU NVIDIA.O TEU SERVIDORTerminaisNavegador ouaplicação desecretáriaAndroid ouTelegramCoreControlador e gatewaywebContentores dosagentesClaude CodeCodexGPU NVIDIA opcionalSSHWebSocket cifradoHTTPSAgente do hostUm terminal chega ao Core no teu servidor por SSH, um navegador ou a aplicação de secretária por um WebSocket cifrado, e Android ou Telegram por HTTPS; o Core executa os contentores dos agentes no mesmo servidor, opcionalmente com uma GPU NVIDIA.O TEU SERVIDORTerminaisNavegadorou aplicaçãodesecretáriaAndroid ouTelegramCoreControlador e gateway webContentores dos agentesClaude CodeCodexGPU NVIDIA opcionalSSHWebSocket cifradoHTTPSAgente do host
  • devctrl tui remote mostra a consola alojada no servidor por SSH; devctrl web remote abre a sua ligação HTTPS privada.
  • Ativa o passthrough de GPU NVIDIA por projeto, ou executa um serviço de GPU como o Ollama e concede-o aos projetos escolhidos. O ecrã Hosts mostra cada GPU.
NUVEM · REDE DOMÉSTICA

Um servidor em casa sem IP público

Para uma máquina atrás de um router doméstico, acessível a partir de um telemóvel ou portátil em qualquer rede.

Um telemóvel ou portátil em qualquer rede abre RANDOM-ID.on.devctrl.dev; o edge do devctrl passa a ligação, ainda cifrada, ao servidor de casa pelo túnel que o seu conector abriu, por isso o router não precisa de portas abertas nem de endereço público.REDE DOMÉSTICATelemóvel ouportátilQualquer redeEdge do devctrlRANDOM-ID.on.devctrl.devServidor de casaCore e consola webConector incluídoHTTPS, TLS terminano teu servidorTúnel cifradoUm telemóvel ou portátil em qualquer rede abre RANDOM-ID.on.devctrl.dev; o edge do devctrl passa a ligação, ainda cifrada, ao servidor de casa pelo túnel que o seu conector abriu, por isso o router não precisa de portas abertas nem de endereço público.REDE DOMÉSTICATelemóvel ou portátilQualquer redeEdge do devctrlRANDOM-ID.on.devctrl.devServidor de casaCore e consola webConector incluídoHTTPS, TLS termina no teu servidorTúnel cifrado
  • devctl cloud link adiciona o servidor ao devctrl Cloud e dá à sua consola um endereço estável, RANDOM-ID.on.devctrl.dev, sem domínio próprio, túnel rápido nem porta aberta.
  • devctl cloud connect mostra a ligação para as aplicações de secretária e móveis e o comando de terminal para esse endereço.
NUVEM · VÁRIOS SERVIDORES

Vários servidores, uma conta devctrl Cloud

Para quem tem um servidor em casa, outro no escritório e uma máquina com GPU.

Inicias sessão em app.devctrl.dev com GitHub, GitLab ou Google e vês todos os servidores ligados; cada servidor mantém um túnel de saída cifrado até ao edge do devctrl, e o portátil ou telemóvel abre cada consola no seu próprio endereço on.devctrl.dev.Portátil outelemóvelapp.devctrl.devInício de sessãocom GitHub, GitLabou GoogleTodos os teusservidoresEdge do devctrlRANDOM-ID.on.devctrl.devServidor de casaServidor doescritórioMáquina com GPUGPU NVIDIAUm só início desessãoHTTPSTúnel cifradoInicias sessão em app.devctrl.dev com GitHub, GitLab ou Google e vês todos os servidores ligados; cada servidor mantém um túnel de saída cifrado até ao edge do devctrl, e o portátil ou telemóvel abre cada consola no seu próprio endereço on.devctrl.dev.Portátil ou telemóvelapp.devctrl.devInício de sessãocom GitHub, GitLabou GoogleTodos os teusservidoresEdge do devctrlRANDOM-ID.on.devctrl.devServidor decasaServidor doescritórioMáquina comGPUGPU NVIDIAUm só início de sessãoHTTPSTúnel cifrado
  • Executa devctl cloud link em cada servidor e aprova o seu código de dispositivo no navegador; cada servidor recebe o seu próprio endereço aleatório.
  • devctl cloud login inicia sessão no teu computador, devctl cloud servers lista todos os servidores e devctl cloud open abre a consola.
NUVEM · ORGANIZAÇÃO DE EQUIPA

Uma organização de equipa no devctrl Cloud

Para uma equipa em que cada pessoa entra nos servidores com a sua própria conta.

Os colegas convidados por email iniciam sessão na organização em app.devctrl.dev, abrem a consola de um servidor através do edge do devctrl e iniciam sessão no seu Core com a conta devctrl Cloud.Colegas deequipaConvidados por emailapp.devctrl.devOrganização, membros efunçõesInício de sessãocom GitHub, GitLabou GoogleEdge do devctrlServidor AInício de sessão comdevctrl CloudServidor BInício de sessão comdevctrl CloudEntrarHTTPSOpenID ConnectTúnel cifradoOs colegas convidados por email iniciam sessão na organização em app.devctrl.dev, abrem a consola de um servidor através do edge do devctrl e iniciam sessão no seu Core com a conta devctrl Cloud.Colegas de equipaConvidados por emailapp.devctrl.devOrganização, membros efunçõesInício de sessãocom GitHub, GitLabou GoogleEdge do devctrlServidor AInício de sessão comdevctrl CloudServidor BInício de sessão comdevctrl CloudEntrarHTTPSOpenID ConnectTúnel cifrado
  • Convida pessoas para a organização por email e dá-lhes uma função em cada servidor que usam.
  • Com o início de sessão com devctrl Cloud ativo, os membros entram num Core ligado com a sua conta devctrl Cloud; o Core associa cada conta a um utilizador próprio do servidor.
  • Remover alguém da organização remove também as suas associações aos servidores, pelo que o devctrl Cloud deixa de lhe mostrar esses servidores e de iniciar sessão neles.
NUVEM · PRESTADORES

Os prestadores só veem os seus servidores

Para dar a um prestador ou cliente acesso a alguns servidores, não a todos.

Um prestador inicia sessão em app.devctrl.dev, vê apenas o servidor A, abre-o através do edge do devctrl e inicia sessão nele com devctrl Cloud; o servidor B fica oculto para ele.Prestadorapp.devctrl.devMembro apenas doservidor AEdge do devctrlServidor AInício de sessãopermitidoServidor BInvisível para oprestadorEntrarHTTPSInício de sessão comdevctrl CloudUm prestador inicia sessão em app.devctrl.dev, vê apenas o servidor A, abre-o através do edge do devctrl e inicia sessão nele com devctrl Cloud; o servidor B fica oculto para ele.Prestadorapp.devctrl.devMembro apenas doservidor AEdge do devctrlServidor AInício de sessãopermitidoServidor BInvisível para oprestadorEntrarHTTPSInício de sessão com devctrlCloud
  • Convida-os para a organização e adiciona-os apenas aos servidores em que trabalham; um membro da organização sem função num servidor não vê nenhum servidor.
  • Permite-lhes iniciar sessão com devctrl Cloud nesses servidores; o que podem fazer lá dentro é definido pelo Core.
PLATAFORMAS APPLE · MAC + SERVIDOR

Agentes no servidor, Xcode no teu Mac

Para quem desenvolve para iOS e macOS e precisa de um Mac para builds e simuladores.

Os agentes editam o repositório num contentor no servidor; a cópia local traz o checkout para uma pasta no teu Mac que o Xcode compila; devctl forward traz a porta do backend para o localhost do Mac para o simulador; as pastas de troca sincronizam capturas e registos nos dois sentidos.O TEU MACSERVIDORXcode e o simuladorCompila a cópia localCópia local do repositórioPasta de trocaBackend e servidores dedesenvolvimentoOs agentes editam o repositórioClaude CodeCodexPasta de trocaReencaminhamento de porta paralocalhostCópia local, a cada 30 sCapturas e registosOs agentes editam o repositório num contentor no servidor; a cópia local traz o checkout para uma pasta no teu Mac que o Xcode compila; devctl forward traz a porta do backend para o localhost do Mac para o simulador; as pastas de troca sincronizam capturas e registos nos dois sentidos.O TEU MACSERVIDORXcode e osimuladorCompila acópia localCópia localdorepositórioPasta detrocaBackend eservidoresdedesenvolvimentoOs agenteseditam orepositórioClaudeCodeCodexPasta detrocaReencaminhamentode porta paralocalhostCópia local, a cada30 sCapturas eregistos
  • Cópia local mantém uma pasta no Mac a par do checkout do servidor, incluindo alterações por confirmar, aproximadamente a cada 30 segundos. Abre-a no Xcode e compila.
  • devctl forward add traz uma porta do projeto para o localhost do Mac, para que a app no simulador chegue ao backend que o agente executa.
MISTO · DOIS HOSTS

O teu Mac junta-se ao servidor como host

Para manter as sessões rápidas no Mac e enviar o trabalho pesado para o servidor.

Um Core no servidor gere dois hosts: o Docker local no teu Mac para projetos leves e o servidor para os pesados; o host do Mac liga-se para fora ao Core.O TEU MACSERVIDORConsolaHost do MacProjetos levesCoreUma consola para osdois hostsHost do servidorProjetos pesadosClaude CodeCodexSSH · HTTPSLigação de saída dohostAgente do hostUm Core no servidor gere dois hosts: o Docker local no teu Mac para projetos leves e o servidor para os pesados; o host do Mac liga-se para fora ao Core.O TEU MACSERVIDORConsolaHost do MacProjetos levesCoreUma consola para os dois hostsHost do servidorProjetos pesadosClaude CodeCodexSSH · HTTPSLigação de saída do hostAgente do host
  • devctrl host install local (por SSH) ou devctrl connect URL --local-docker (por HTTPS) regista o Docker do Mac como mais um host.
  • Coloca cada projeto no Mac ou no servidor. devctl project deploy move-o mais tarde, depois de uma paragem confirmada.
EQUIPA · SERVIDOR PARTILHADO

Um servidor para uma equipa inteira

Para vários programadores que partilham capacidade de computação sem partilhar ambientes.

Vários programadores iniciam sessão num único Core no servidor da equipa; cada um recebe contentores de agentes privados com orçamento próprio, e os contentores clonam repositórios partilhados no GitHub ou no GitLab e fazem push para eles.SERVIDOR DA EQUIPAProgramadorAProgramadorBProgramadorCCoreContas deutilizador epolíticaContentoresprivadosUm conjuntoporprogramadorOrçamento porutilizadorRepositóriospartilhadosInício de sessãopróprioAgente do hostClonar e fazerpushVários programadores iniciam sessão num único Core no servidor da equipa; cada um recebe contentores de agentes privados com orçamento próprio, e os contentores clonam repositórios partilhados no GitHub ou no GitLab e fazem push para eles.SERVIDOR DA EQUIPAProgramadorAProgramadorBProgramadorCCoreContas de utilizador e políticaContentores privadosUm conjunto por programadorOrçamento por utilizadorRepositórios partilhadosInício de sessãopróprioAgente do hostClonar e fazer push
  • Instala com --users: cada programador tem os seus próprios projetos, contas, segredos, contentores e armazenamento.
  • Define orçamentos de CPU, memória e armazenamento por utilizador. A utilização por utilizador mostra tokens, custo estimado e disco de cada pessoa.
ELÁSTICO · NUVEM + SANDBOXES

Expandir para máquinas na nuvem e sandboxes

Para correr muitas tarefas temporárias em paralelo sem comprar hardware.

O Core no teu servidor chama as APIs dos fornecedores de nuvem para criar VMs que se juntam como hosts e abrir espaços de trabalho descartáveis em sandboxes; o Overnight pode desligar um servidor na nuvem quando o trabalho termina.O TEU SERVIDORCoreProjetos persistentesVMs na nuvem criadas apedidoDocker e agente do hostClaude CodeEspaços de trabalho descartáveisem sandboxesCheckout separadoAPI do fornecedor: criar,desligarAPI de sandboxO Core no teu servidor chama as APIs dos fornecedores de nuvem para criar VMs que se juntam como hosts e abrir espaços de trabalho descartáveis em sandboxes; o Overnight pode desligar um servidor na nuvem quando o trabalho termina.O TEU SERVIDORCoreProjetos persistentesVMs nanuvemcriadasapedidoDocker e agente dohostClaude CodeEspaços detrabalhodescartáveis emsandboxesCheckout separadoAPI do fornecedor: criar,desligarAPI de sandbox
  • Os adaptadores de nuvem criam uma VM na Hetzner, DigitalOcean, Vultr, Linode, Hostman ou Proton, instalam o Docker e registam-na como host.
  • Overnight arquiva o trabalho no teu armazenamento S3 e desliga o servidor na nuvem quando todas as sessões terminaram ou precisam de ti.
DOIS CORES · FEDERAÇÃO

Um Core pessoal ligado ao da empresa

Para manter a tua instalação separada enquanto os seus agentes trabalham com os de uma equipa.

Um Core pessoal e um Core da empresa, cada um com os seus hosts, contas e segredos, trocam listas de sessões e mensagens de projeto para um projeto ligado por HTTPS assinado.Core pessoalOs teus hosts, contas e segredosClaude CodeCore da empresaHosts, contas e segredos da equipaCodexHTTPS assinado: sessões emensagensUm Core pessoal e um Core da empresa, cada um com os seus hosts, contas e segredos, trocam listas de sessões e mensagens de projeto para um projeto ligado por HTTPS assinado.Core pessoalOs teus hosts, contas e segredosClaude CodeCore da empresaHosts, contas e segredos da equipaCodexHTTPS assinado: sessões e mensagens
  • Os agentes enviam mensagens a uma sessão do outro Core como @handle@coreId; as mensagens ficam em fila enquanto o par está offline.
  • Ficheiros, terminais, credenciais, hosts e orçamentos nunca são partilhados.
SEUS AGENTES. SUA INFRAESTRUTURA.

Põe o teu servidor a trabalhar.

Dê aos seus agentes espaços de trabalho remotos persistentes. Comece com um repositório e um servidor e depois adicione projetos, desenvolvedores e recursos no mesmo console.