Primeiros passos

Você entra no painel do Cadrix Cloud (Entrar, no topo deste site) por link mágico (sem senha para decorar), escolhe um plano e paga. O painel então cria o seu servidor, liga a máquina, instala o Cadrix e emite um certificado TLS para seu-endereco.cadrix.app. Costuma levar uns quatro minutos; pode fechar a página e voltar depois.

Quando o status mostrar Pronto, clique em Abrir o Cadrix. O painel mostra a senha do seu Cadrix uma única vez: guarde num gerenciador de senhas, porque o painel apaga a cópia assim que você fecha o diálogo. Se perder, escreva para [email protected].

• Uma VM por assinatura. Tudo o que vem abaixo roda nessa máquina: o canvas, os agentes, seus repositórios e qualquer app que você rodar.
• Seu endereço é seu-endereco.cadrix.app. Abra de qualquer navegador, inclusive no celular, e instale-o como app.
• Região: Alemanha (Nuremberg ou Falkenstein) ou Finlândia (Helsinque), conforme a capacidade na hora de criar a VM.

O canvas

Um workspace é uma pasta na sua VM (normalmente um repositório) e um canvas para ela. A barra lateral à esquerda lista os workspaces; a toolbar no topo adiciona itens ao canvas; os controles no canto inferior direito dão zoom e enquadram.

200 OK · 23 ms · application/json
[{ "id": 1042, "total": 2800, "status": "paid" }, …]

Três tipos de item vivem no canvas:

• Agentes: uma sessão de Claude Code, Codex ou Pi, mostrada como terminal ou como chat.
• Notas e binders: arquivos Markdown fixados no canvas, opcionalmente agrupados num binder com páginas.
• Portais de navegador: um Chromium real que os agentes controlam e você acompanha.

Cabos são permissões. Um agente só fala com os agentes, notas e navegadores ligados a ele. Desenhe um cabo para dar acesso; apague para revogar. Não existe outra lista de acesso para manter.

A toolbar oferece, da esquerda para a direita: selecionar, adicionar agente, adicionar navegador, adicionar nota, adicionar binder, arranjo automático (com desfazer), modo foco, multi-workspace e excluir. Os itens podem ser arrastados, redimensionados e ligados arrastando a partir do ponto azul na borda.

Agentes: terminal ou chat

Ao adicionar um agente você escolhe o runtime (Claude Code, Codex ou Pi), um nome e um papel. O papel é um briefing curto que o agente recebe a cada início (presets como developer-backend, reviewer ou qa, ou um texto seu). Cada agente ganha um diretório home privado na VM e o CLI do Cadrix já autenticado.

Todo agente tem duas faces, alternadas pelo toggle Chat | Terminal na barra de título:

• Terminal: o CLI oficial rodando numa sessão tmux. Sobrevive a recarregar a página e continua rodando enquanto você está longe; tudo que dá para fazer num terminal, o agente faz.
• Chat: um transcript gráfico sobre o mesmo runtime. Chamadas de ferramenta viram cartões (Read, Write, Edit, Bash, ações de navegador), caminhos de arquivo são clicáveis e abrem o editor, e tarefas longas mostram uma linha do tempo.

tmux · cadrix_nd_8c6d…
› Implement the /v1/billing webhook with idempotent event ids.
• Read src/billing/webhooks.ts
• Edit src/billing/webhooks.ts (+38 −4)
• Bash pnpm test -- billing
  41 passed
› 

No modo chat, o composer carrega as configurações da sessão: modelo, esforço, permissões (por exemplo, dispensar confirmações para trabalho sem supervisão), pensamento estendido onde o runtime suporta, e um medidor de contexto mostrando quanto da janela já foi usado. Você pode anexar arquivos e imagens, enfileirar uma mensagem para depois do turno atual, redirecionar o agente no meio do turno, parar uma resposta e abrir o painel de Subagentes quando o agente cria ajudantes. A barra de título mostra o status: busy, idle, starting, stopped.

A sessão acima é roteirizada, mas o jogo é real: foi escrito por um agente exatamente assim, servido da VM e aberto num portal de navegador no mesmo canvas.

Conectando seus provedores de modelo

Dois jeitos de pagar pelos modelos, escolhidos por runtime na engrenagem de configurações do chat, em Credenciais do modelo: sua própria assinatura ou chave de API, cujas credenciais ficam só na sua VM, cifradas em repouso (o painel nunca as vê), ou créditos Cadrix. No modo Automático, o padrão, o runtime usa a sua credencial quando ela existe e créditos quando não existe, então uma VM nova funciona desde o primeiro chat sem configurar nada.

• Claude Code: Sign in with Claude abre a página de login no seu navegador; cole o código de volta e o CLI fica autenticado. Sem terminal.
• Codex: Sign in with ChatGPT, mesmo fluxo.
• Pi e qualquer um dos três também aceitam chave de API (Anthropic, OpenAI, Google, OpenRouter e outros provedores que o Pi suporta).

O chat mostra um alerta discreto na engrenagem de configurações quando um runtime ainda não tem credenciais. Os termos são definidos pelos provedores e podem mudar; chaves de API são sempre o caminho totalmente suportado.

Agentes conversando entre si: o CLI cadrix

Todo agente tem o comando cadrix no PATH, já autenticado como aquele nó. É assim que os agentes delegam, compartilham notas e controlam navegadores, e ele só alcança os itens ligados a eles por cabo.

$ cadrix peers
{ "peers": [ { "name": "Reviewer", "kind": "agent", "status": "idle", "agent": "codex" },
             { "name": "Plan",     "kind": "note" } ] }
$ cadrix ask "Reviewer" "Review src/billing/webhooks.ts for retries and idempotency. Reply with a list of issues." --timeout 10m
… waiting for Reviewer …
1. The Stripe event id is not stored, so a redelivered event is processed twice.
2. …
$ cadrix note append "Plan" "- [ ] store stripe event ids (Reviewer)"

Agentes em modo chat recebem uma skill que ensina esses comandos, então "peça ao Reviewer para conferir isso" em linguagem natural já basta.

Times Maestro

O Maestro transforma um agente em gerente. Você habilita no nó do agente; o gerente pode então recrutar até oito especialistas e criar até dois portais de navegador no mesmo workspace, tudo pelo CLI, enquanto você vê o time se montar no canvas.

• Recrutar com um preset de papel ou um briefing próprio, escolhendo o runtime e o modo terminal ou chat. Cada recruta já nasce ligado ao gerente por cabo.
• Passar o briefing e coletar com os ask e tell comuns; o gerente consolida os resultados.
• Notas para o time: o gerente pode criar notas compartilhadas e ligá-las explicitamente aos recrutas.
• Reatribuir ou dispensar recrutas ociosos; a dispensa limpa o runtime e as credenciais antes de remover o nó.
• Atenção: um recruta ou o gerente pode acender um indicador na interface quando precisa de uma decisão humana.

O Maestro é opcional por agente e verificado no servidor; um agente comum não consegue se promover.

Squads: times prontos

Um squad é um time montado para um resultado: um líder com Maestro, os especialistas de que ele precisa, uma nota compartilhada do time e os cabos entre eles, cada agente com o briefing do seu papel e as skills para ele. Abra Criar um agente, vá à aba Squads, escolha um card, escolha o modelo de cada membro (ou o mais barato para todos), escreva o briefing, e o time aparece no canvas. O líder te cumprimenta no chat dele sem gastar nada; você manda a primeira mensagem, ele discute a abordagem e confirma o plano com você antes de delegar. Marque Começar já se preferir que ele planeje e despache sozinho a partir do briefing.

• Skills são gravadas no workspace em .claude/skills/<nome>/SKILL.md; o Claude Code as carrega, e cada arquivo de papel as lista por caminho para o Codex e o Pi lerem também. Edite à vontade: são suas.
• Runtimes e modelos seguem o que está logado no seu Cadrix (ou os seus créditos); cada membro prefere o Claude Code, com QA e revisores no Codex para uma segunda opinião independente. O modelo que você escolhe por membro fica gravado no nó, então um especialista parado roda com ele; troque quando quiser no chat do agente, mesmo parado.
• A nota do time guarda o briefing, o plano e o quadro de status; o líder a mantém em dia e é por ela que você acompanha.
• Um agente vivo. Só o líder roda desde o início; cada especialista nasce parado e acorda para a tarefa que o líder delega, depois para. Um squad cabe no plano Starter.
• Em créditos Cadrix, cada agente que trabalha consome do seu saldo; uma missão pequena costuma gastar cerca de US$ 1 a 3 (medido: só a coordenação do líder custou cerca de US$ 0,87 em um minuto com o Sonnet 5). O diálogo avisa isso quando seus runtimes rodam em créditos.
• Depois de criado, um squad é um time Maestro comum: reatribua ou dispense recrutas, adicione notas, habilite um portal de navegador para o QA.

Notas e binders

Notas são arquivos Markdown de verdade fixados no canvas. Sobrevivem a reinícios, você vê os agentes editarem ao vivo, e são o lugar natural para planos, listas de tarefas e passagens de bastão entre agentes.

Acima, uma sessão roteirizada: o agente lê a nota com cadrix note read, marca uma tarefa com note write e acrescenta uma linha com note append; a nota no canvas se atualiza na hora.

• Edite no lugar com um toggle Edit | Preview, adicione imagens, escolha uma cor.
• Binders agrupam várias páginas num só item; os agentes leem um binder inteiro de uma vez.
• Agentes usam cadrix note append em vez de write quando vários compartilham uma nota, para ninguém sobrescrever os outros.

Portais de navegador

Um portal de navegador é um Chromium real rodando na sua VM, mostrado ao vivo dentro do canvas. Os agentes ligados a ele podem abrir URLs, tirar um snapshot de acessibilidade, clicar, digitar, esperar por um texto, capturar a tela e ler os logs de console e de rede; você acompanha e assume quando quiser.

Cada portal fica contido no próprio perfil e grupo de processos e mostra o status na barra de título (starting, running, stopped). Os planos limitam quantos portais rodam ao mesmo tempo. Os cabos valem aqui também: um navegador só é visível para os agentes ligados a ele.

Previews e subdomínios

Tudo que seus agentes rodam na VM já está na web. Toda porta em escuta ganha um endereço HTTPS em cxapp.dev (um domínio separado do cadrix.app de propósito), com certificado curinga emitido e renovado por nós: nada para configurar, nenhum servidor para montar.

• Por porta: um servidor na porta 3000 responde em https://3000.voce.cxapp.dev.
• Por nome: ligue um nome a uma porta e ele vira https://snake.voce.cxapp.dev. Nomes usam letras minúsculas, números e hífen, começam por letra e têm até 32 caracteres.
• Privado por padrão. Um preview só abre para quem está logado no seu Cadrix; qualquer outra pessoa é mandada para o login. Público por escolha, por porta ou por nome, depois de uma confirmação que mostra o link; dá para voltar a privado a qualquer momento. Público é para o que deve ser visto: uma demo, um link para um colega, um endpoint de webhook.
• Dev servers simplesmente funcionam. WebSockets passam, então o hot reload funciona pelo endereço do preview; o cabeçalho Host é reescrito, então servidores que o validam (Vite, Next) ficam satisfeitos.
• Portas usadas pelo sistema e pelo próprio Cadrix nunca viram preview; só as portas abertas pelos seus agentes.

Pela interface: o botão Previews na barra lateral (também no cockpit do celular). Subdomains lista cada nome com a porta, os selos Private/Public e Running, e Open, Copy, a chave Private | Public e Remove; o formulário abaixo liga um nome a uma porta. Listening ports mostra o que está rodando agora, com as mesmas ações e mais Name it.

Por um agente: o CLI tem o comando preview, e a skill do agente o orienta a registrar um preview depois de subir um servidor e te passar o link. Ele só torna um preview público se você pedir.

$ cadrix preview list
$ cadrix preview add snake 3000
{ "name": "snake", "port": 3000, "public": false,
  "url": "https://snake.you.cxapp.dev/", "listening": true }
$ cadrix preview public snake on
$ cadrix preview url snake
https://snake.you.cxapp.dev/
$ cadrix preview remove snake

Domínios personalizados. Aponte um domínio seu (como app.suaempresa.com) para uma porta, no mesmo painel onde você dá nome a um subdomínio. Crie um CNAME no seu domínio apontando para voce.cxapp.dev (um domínio apex precisa de um registro A/ALIAS em vez disso, no endereço que o painel mostra), depois um registro TXT em _cadrix-challenge.app.suaempresa.com com o token que o Cadrix te dá, para provar que é seu. O painel mostra o estado — esperando o DNS, DNS ainda não aponta para aqui, ativo, ou perdido se o registro TXT desaparecer depois — e um domínio personalizado é privado ou público exatamente como a porta que ele serve. Até 5 por máquina.

O que ainda não é: um deploy de produção com escala, CDN ou garantia de disponibilidade. É o seu app rodando na sua VM, com certificado TLS próprio de todo jeito.

Editor de código

O Cadrix Code é o editor do workspace, a um clique do canvas. É um editor Monaco com explorador de arquivos, abertura rápida e um painel de controle de versão com diffs, descartar e commit. O painel de agentes fica ao lado, então você revisa uma mudança e responde ao agente na mesma tela; clicar num caminho de arquivo no chat abre o arquivo aqui.

Cliente HTTP

Um cliente no estilo Postman embutido no editor: coleções de requisições, ambientes com variáveis, segredos guardados fora da coleção, corpos de vários tipos e um visualizador de resposta. Importe um JSON do Postman, exporte uma coleção ou um ambiente.

Cliente de banco de dados

Conecte em bancos Postgres ou MySQL acessíveis da sua VM e consulte-os num SQL book com autocompletar. Os resultados são paginados e podem ser exportados; as conexões podem ser importadas e atualizadas.

Modo foco

O modo foco transforma o canvas em painéis estilo tmux para você se concentrar em poucos itens em tamanho cheio. Cada painel tem abas; cada aba é um item do canvas (agente, nota, navegador ou binder) com o ícone do tipo e o ponto de status.

• Divida um painel à direita ou abaixo, maximize um painel, feche painéis, arraste abas entre painéis.
• Abrir um item aqui lista tudo do canvas com uma busca; um painel vazio mostra a mesma busca.
• As abas mostram os cabos: um selo amarelo lista a que o item está ligado.

Multi-workspace

A visão multi-workspace usa os mesmos painéis do modo foco, mas as abas são itens fixados de qualquer workspace. Acompanhe o agente de backend de um projeto ao lado das notas de outro. O layout é salvo no servidor e te acompanha em todos os dispositivos e abas.

• Abra pela toolbar ou com ?view=multi no endereço; dá para salvar nos favoritos.
• O seletor agrupa os itens por workspace. Cada aba traz o chip do workspace e um botão ir ao workspace que pula para aquele item no próprio canvas.

Instale o Cadrix como app

O jeito mais simples de usar o Cadrix em qualquer aparelho é instalá-lo pelo navegador. Ele ganha ícone e janela próprios (tela cheia no celular), abre direto no seu Cadrix e sempre roda a versão do seu servidor: não há nada para baixar nem atualizar. Abra o seu endereço, entre e então:

O app instalado é o mesmo Cadrix que você abre numa aba: mesmo login, mesmos dados. Para remover, desinstale como qualquer app (toque longo no ícone no celular, ou pelo menu da janela do app no computador).

Cockpit no celular

Seu Cadrix funciona no navegador do celular, no seu endereço. Para ter ícone próprio e o cockpit em tela cheia, instale-o como app.

Você também pode parear um aparelho em Configurações → Celulares: crie um QR code, escaneie e aprove o aparelho com o código de confirmação. O aparelho recebe um token próprio, então você nunca digita sua senha no celular, e pode revogá-lo depois.

O cockpit tem três botões embaixo. Ele abre em Multi: todos os itens fixados de qualquer projeto, com o que cada agente está fazendo. Toque num agente para abrir o chat e responder, ou numa nota para ler ou editar; Fixar um item acrescenta outros.

• Canvas: o canvas de um projeto, somente leitura. Arraste e dê zoom para ver agentes, notas, navegadores e cabos; os nós não podem ser movidos, redimensionados, conectados nem apagados pelo celular. O seletor de projeto acima dele escolhe qual canvas é mostrado, e Entrar no modo foco abre um nó em tela cheia. Um selo no botão conta os agentes que precisam da sua atenção.
• + (Criar): um agente de chat ou de terminal, um squad, uma nota ou um portal de navegador num projeto, ou um Novo projeto.
• O filtro Todos os projetos no topo restringe o Multi e o canvas a um projeto.

Sua conta e seu plano

Os planos são tamanhos de VM. Todos incluem o Cadrix, TLS no seu endereço e os mesmos recursos; diferem em CPU, memória, disco e em quantos agentes e navegadores rodam com folga ao mesmo tempo.

• Moeda: no Brasil, os planos são cobrados no cartão em reais, pelo preço promocional de R$ 79, R$ 159 e R$ 319 por mês, 20% de desconto (o preço regular será de R$ 99, R$ 199 e R$ 399 ao fim da promoção); nos demais países, em dólares. Cartões emitidos no Brasil são cobrados só em reais.
• Cobrança pelo Stripe; Gerenciar assinatura no painel abre o portal do cliente para trocar o cartão ou cancelar.
• Créditos: o painel mostra o saldo e vende pacotes de US$ 10, 25 e 50; veja créditos Cadrix.
• Mudar de plano: escreva para [email protected] e nós movemos sua VM para o novo tamanho, com uns dois minutos de parada. A troca por conta própria está a caminho.
• Cancelar encerra a assinatura; quando ela termina, a VM e o endereço são apagados. Envie seus repositórios para outro lugar antes.
• Atualizações: sua VM só instala versões do Cadrix assinadas por nós e atualiza em uns vinte segundos.

Suporte

O suporte roda por chat dentro do app: responde na hora pela documentação e pelos fatos da sua conta, e o que não consegue resolver sozinho é registrado para o nosso time revisar assim que você encerrar a conversa.

• Horário do atendimento humano: segunda a sexta, 9h às 17h (horário de Brasília), com primeira resposta em até 1 hora nesse período. Fora dele, a resposta vem no próximo dia útil a partir das 9h.
• Nota fiscal: não emitimos por padrão, só sob pedido pelo suporte. Peça no chat e tenha em mãos seu nome ou razão social, CPF ou CNPJ, endereço de cobrança e e-mail.

Créditos Cadrix

Créditos são um saldo pré-pago, em dólares, que paga o uso de modelo por token, para o Claude Code e o Codex funcionarem sem assinatura nem chave sua. Toda conta começa com US$ 2; pacotes de US$ 10, 25 e 50 são vendidos no painel pelo Stripe. No Brasil, o pacote é cobrado em reais pela PTAX do dia, do Banco Central, sem spread; o saldo continua em dólares. Créditos não expiram, pertencem à sua conta e não à VM, e o uso para no zero: você nunca paga além do que comprou.

• Onde você os vê. O chat mostra o saldo ao lado do seletor de modelo e, quando ele acaba, um aviso com duas saídas: comprar créditos ou conectar o seu próprio login.
• Barato por padrão. Com créditos, o Claude Code começa no Sonnet e o Codex no modelo mini; cada modelo do seletor diz quanto gasta em relação a esse padrão antes de você trocar.
• Vale a partir do próximo início. Mudar o modo de credencial vale na próxima vez que o runtime iniciar, não no meio da conversa.

Preços por milhão de tokens, em dólares, já com a nossa margem sobre o preço de lista dos provedores. Eles mudam quando os provedores mudam os deles; vale o preço do momento de cada chamada.

Segurança e dados

• VM dedicada. Seu Cadrix não é um container num host compartilhado. Repositórios, credenciais dos agentes e dados ficam no disco dela.
• Tráfego de modelo. Com o seu login ou a sua chave, os agentes chamam Anthropic, OpenAI e outros provedores direto da VM; nunca lemos seus tokens. Com créditos, as chamadas passam pelo nosso gateway de modelos, que registra metadados de uso (modelo, tokens, custo, horário) para cobrança e nunca guarda prompts nem respostas.
• Agentes têm shell de verdade na sua VM, por desenho. Os cabos limitam o que alcançam dentro do Cadrix; a fronteira da VM limita todo o resto.
• Plano de dados em loopback. O CLI que os agentes usam só fala com o Cadrix de dentro da VM, com um token por nó que nunca aparece na interface.
• Uma senha protege a interface do Cadrix, guardada com Argon2; aparelhos móveis usam tokens próprios, revogáveis.
• Uso aceitável: sem mineração, spam, varreduras ou ataques; a porta 25 fica fechada. Veja os termos e a política de privacidade.