Documentação

Documentação › Draw

Draw

O Draw é um cartão com um quadro do Excalidraw dentro. Você desenha à mão livre ou com formas, e um agente ligado por cabo desenha no mesmo quadro: peça um fluxograma e ele aparece ao lado, com caixas e setas que você pode editar.

Criar um Draw

MacWindowsLinuxdesde a 1.0.27

O Draw nasce vazio, no tamanho padrão de 840 × 600. O pé do cartão mostra o traço e quantos elementos o desenho tem, como “à mão · 12 elementos”.

Um Draw vazio ao lado de um terminal
Um Draw vazio ao lado de um terminal

Passo a passo

  1. Com nada escolhido, aperte X ou clique em Draw na barra de ferramentas do alto.
  2. Clique no canvas onde o cartão vai ficar. Para escolher o tamanho, arraste em vez de clicar.
  3. Nas Abas, clique no “+” e escolha Draw. No Windows e no Linux, a paleta de ações (Ctrl+Shift+P) também tem “Novo Draw”.
  4. O quadro vazio diz “Desenhe aqui, ou ligue um agente e peça um diagrama”.
DrawX

Para dar outro nome ao cartão, use “Renomear…” no menu dele.

Veja tambémDesenhar no quadroPedir um fluxograma a um agenteBarra de ferramentas

Desenhar no quadro

MacWindowsLinuxdesde a 1.0.27

O Excalidraw só recebe o mouse quando o Draw é o único cartão escolhido. Assim o primeiro clique escolhe o cartão e um arrasto move o cartão, sem riscar nada sem querer.

O Draw escolhido, com a barra de ferramentas do Excalidraw
O Draw escolhido, com a barra de ferramentas do Excalidraw

Passo a passo

  1. Clique no Draw uma vez para escolhê-lo. Esse clique não desenha.
  2. Com ele escolhido sozinho, use a barra do Excalidraw no alto do quadro: formas, setas, linhas, lápis, texto, imagem e borracha.
  3. As teclas do Excalidraw funcionam no quadro: ⌘ZCtrl+Z desfaz, ⇧⌘ZCtrl+Y refaz, ⌘ACtrl+A escolhe tudo, ⌘DCtrl+D duplica e ⌘GCtrl+G agrupa elementos.
  4. ⌘CCtrl+C e ⌘VCtrl+V copiam e colam elementos dentro do quadro.
  5. Aperte Esc para cancelar o que está no meio, como um texto ou uma forma. Sem nada para cancelar, o Esc devolve o teclado ao canvas.
  6. Um link num elemento abre no seu navegador.
Desfazer no desenho⌘ZCtrl+Z
Refazer no desenho⇧⌘ZCtrl+Y
Devolver o teclado ao canvasEsc

Com vários cartões escolhidos, nenhum Draw recebe o mouse. Nas Abas, o Draw ocupa a parte inteira e já recebe o mouse, sem o clique de escolher.

Veja tambémTraço à mão ou limpo, e o menu do quadroZoom e movimento dentro do quadroBarra da parte

Traço à mão ou limpo, e o menu do quadro

MacWindowsLinuxdesde a 1.0.27

O desenho começa com traço à mão, com a letra manuscrita do Excalidraw. O traço limpo troca o desenho inteiro para linhas retas e letra sem serifa, com Desfazer, e o cartão guarda a escolha.

O menu ☰ do quadro

Passo a passo

  1. Com o Draw escolhido, abra o menu ☰ no canto de cima do quadro.
  2. Clique em “Traço: à mão” para trocar para o traço limpo. O item passa a dizer “Traço: limpo”; clique de novo para voltar.
  3. “Limpar o canvas e redefinir a cor de fundo” apaga o desenho, depois de confirmar.
  4. “Fundo da tela” troca a cor de fundo do quadro. Sem escolha, o fundo é o do cartão.
  5. “Ajudar” mostra os atalhos do Excalidraw.
  6. O pé do cartão mostra o traço atual: “à mão” ou “limpo”.

Um agente ligado também troca o traço. Peça, por exemplo, “deixe o desenho com traço limpo”.

Veja tambémPedir um fluxograma a um agente

Imagens no desenho

MacWindowsLinuxdesde a 1.0.27

Fotos e prints entram no quadro como elementos do desenho. Você arrasta o arquivo para o cartão, cola uma imagem copiada ou usa a ferramenta de imagem do Excalidraw.

Um print dentro do desenho, com setas apontando partes dele
Um print dentro do desenho, com setas apontando partes dele

Passo a passo

  1. Escolha o Draw com um clique.
  2. Arraste uma imagem do Finder (ou da pasta do sistema, no Windows e no Linux) para cima do cartão. Ela entra onde você soltou.
  3. Ou copie uma imagem e cole com ⌘VCtrl+V, com o Draw escolhido.
  4. Valem PNG, JPEG, GIF, WebP e SVG.
  5. O desenho inteiro tem um limite de 12 MB. Se uma imagem passaria disso, o quadro avisa “O desenho passaria de 12 MB: a imagem não entrou. Use imagens menores ou menos imagens.”

Solta fora de um Draw, a imagem vira um cartão de imagem no canvas. Sobre o Draw, ela entra no desenho.

Veja tambémSoltar arquivos

Zoom e movimento dentro do quadro

MacWindowsLinuxdesde a 1.0.27

Com o Draw escolhido sozinho, a pinça, a roda do mouse e o botão do meio agem no desenho, não no canvas. Com ele não escolhido, os mesmos gestos movem e dão zoom no canvas, como sempre.

Zoom e movimento no desenho com o Draw escolhido

Passo a passo

  1. Clique no Draw para escolhê-lo sozinho.
  2. Para dar zoom no desenho: pinça no trackpad, ou ⌘Ctrl com a roda do mouse.
  3. A roda do mouse sozinha também dá zoom no desenho quando Ajustes › Geral › “Roda do mouse no canvas” está em “Dá zoom, como a pinça”.
  4. Para mover o desenho: dois dedos no trackpad, ou arraste com o botão do meio do mouse.
  5. No Mac, ⌥ com a roda age no canvas como fora do Draw: com a roda em “Dá zoom, como a pinça”, move o canvas; em “Move o canvas”, dá zoom.
  6. O desenho abre encaixado no cartão. Se você mexeu no zoom ou na posição, o quadro guarda essa vista e abre nela da próxima vez.
Zoom no desenho⌘ + rodaCtrl + roda

Quando o cartão muda de tamanho (o modo padrão, por exemplo) e você não mexeu na vista do quadro, o desenho se encaixa de novo.

Veja tambémGeralZoom e roda do mouse

Pedir um fluxograma a um agente

MacWindowsLinuxdesde a 1.0.27

Um Claude Code ou Codex ligado ao Draw por cabo desenha nele quando você pede um fluxo, um diagrama, uma arquitetura ou um mapa mental. O desenho chega ao vivo, com elementos editáveis, e você pode desfazer o que ele fez.

O agente desenha o fluxo do login no Draw ligado a ele

Passo a passo

  1. Ligue o terminal do agente ao Draw: aperte ⌘LCtrl+Shift+L e clique no Draw, ou arraste o botão de ligar da barra até ele.
  2. Peça na conversa, por exemplo: “faça um fluxograma do login da Loja”.
  3. O agente escreve o diagrama em mermaid e o Octopus o transforma em caixas, setas e textos do Excalidraw, ao lado do que já existe no quadro.
  4. Depois ele confere uma imagem do desenho e corrige caixas sobrepostas ou setas cruzadas.
  5. Se você estiver desenhando ao mesmo tempo, a mudança dele entra junto com a sua. Com o Draw escolhido, ⌘ZCtrl+Z desfaz o que ele desenhou.
  6. Sem nenhum Draw ligado, o agente cria um ao lado dele, já ligado.
Iniciar conexão⌘LCtrl+Shift+L

O Draw só se liga a terminais. Com um único Draw ligado, o agente nem precisa saber o nome dele. O Maestro também cria Draws para o time.

Veja tambémO aviso “desenhou”Os comandos do agente (octo draw)Agentes que conversam pelos cabosComo ele recruta

O aviso “desenhou”

MacWindowsLinuxdesde a 1.0.27

Quando um agente muda o desenho, o pé do cartão mostra por uns segundos quem foi, como “Claude desenhou · agora”. Depois volta ao traço e à contagem de elementos.

O pé do Draw logo depois de um agente desenhar
O pé do Draw logo depois de um agente desenhar

Passo a passo

  1. Olhe o pé do Draw enquanto o agente trabalha.
  2. O aviso traz o nome de quem desenhou: Claude, Codex ou o nome do cartão do agente.
  3. Se você não mexeu na vista do quadro, o desenho inteiro se encaixa para mostrar o que ele fez.

Veja tambémPedir um fluxograma a um agente

Os comandos do agente (octo draw)

MacWindowsLinuxdesde a 1.0.27

Os agentes desenham com o comando octo draw, que vem com a skill do Octopus. Você não precisa digitar nada: esta lista serve para entender o que o agente faz e para pedir algo específico.

Passo a passo

  1. octo draw new “Nome”: cria um Draw ao lado do agente, ligado a ele.
  2. octo draw read: lista os elementos (id, tipo, rótulo, posição e o que cada seta liga) e a revisão do desenho.
  3. octo draw mermaid: transforma um diagrama em mermaid em elementos editáveis. Com --replace, troca o desenho inteiro; sem ele, desenha ao lado do que existe.
  4. octo draw add: acrescenta formas exatas (retângulo, elipse, losango, texto, seta, linha). As setas se prendem aos elementos pelo id; sem posição, os elementos se arrumam sozinhos num lugar livre.
  5. octo draw update, delete e clear: mudam um elemento, apagam elementos ou limpam o quadro.
  6. octo draw look sketch ou clean: traço à mão ou limpo.
  7. octo draw write: troca o desenho inteiro por um arquivo .excalidraw. O agente só usa quando você pede.
  8. octo draw png ou svg: salva uma imagem do desenho para o agente conferir o que fez.
  9. Com --rev, a mudança só entra se ninguém mexeu no desenho desde a leitura. Senão o agente lê de novo e refaz.

Com um só Draw ligado, o nome é opcional em todos os comandos.

Veja tambémocto draw

O desenho fica guardado

MacWindowsLinuxdesde a 1.0.27

O desenho grava sozinho a cada mudança. Ele vai junto quando o cartão é copiado, muda de workspace ou entra num grupo salvo.

Passo a passo

  1. Não há botão de salvar: cada traço grava logo em seguida.
  2. Copie o cartão com o teclado no canvas (⌘CCtrl+C e depois ⌘VCtrl+V): o novo Draw sai com uma cópia do desenho.
  3. Mover o Draw para outro workspace ou salvar o grupo dele leva o desenho.
  4. Excluir o Draw manda o desenho para a Lixeira. ⌘ZCtrl+Z logo depois traz o cartão de volta com o desenho.
  5. Ao fechar o Octopus, ele grava o que ainda faltava.

Veja tambémSalvar um grupoCopiar, colar e desfazer