GitHub Começar

Agente

Linear

Atribua uma issue do Linear ao Comma ou mencione @Comma em um comentário. O Comma responde na issue, executa o trabalho como uma tarefa no seu workspace e publica o progresso e os resultados na issue.

Antes de começar

  • Um workspace do Comma, no app de desktop ou em app.comma.surf.
  • Uma conta do Linear no workspace onde você quer usar o Comma. A primeira pessoa a conectar em um workspace do Linear instala o Comma lá, o que exige um administrador do workspace do Linear. As seguintes só vinculam a própria conta.
  • Uma forma de executar o trabalho: seu próprio Codex ou Claude Code conectado ao Comma, ou créditos do Comma para um Worker na nuvem. Respostas na issue não precisam de Worker.

Conectar o Linear

  1. No Comma, abra Configurações, depois Canais, e pressione Conectar no cartão do Linear.
  2. O Linear pede que você autorize o Comma a ler seu workspace em seu nome. É assim que o Comma sabe qual usuário do Linear você é.
  3. Se o Comma ainda não estiver instalado nesse workspace do Linear, o Linear pergunta uma segunda vez. Essa etapa instala o Comma como agente para as equipes que você escolher.
  4. De volta ao Comma, o cartão mostra Conectado, com a organização do Linear e a sua conta.

Cada pessoa conecta a partir do próprio workspace do Comma. As issues que você delega rodam no seu workspace com os seus Workers e créditos. As que um colega delega rodam no dele.

Escolher como suas issues rodam

  • Quando uma tarefa termina. Deixar a issue como está, movê-la para In Review se a sua equipe tiver esse estado, ou movê-la para Done.

Delegar uma issue

  1. No Linear, atribua a issue ao Comma ou escreva @Comma em um comentário com o que você quer.
  2. O Comma responde em segundos na sessão de agente da issue. Uma pergunta, uma triagem ou um plano são respondidos ali, sem tarefa.
  3. Quando a issue exige trabalho de verdade, o Comma inicia uma tarefa. A issue passa para o primeiro estado “iniciado” da sua equipe, In Progress na maioria delas, a menos que já esteja iniciada ou fechada. A sessão recebe um link Task in Comma, e o progresso e o resultado do Worker são publicados na sessão. Um pull request aberto pelo Worker também é vinculado.
  4. Responda na sessão para orientar ou pedir mais. O Comma inicia outra tarefa quando a atual tiver terminado.

Parar ou fechar

  • Pressione Stop na sessão: a tarefa em andamento termina. O trabalho já feito permanece.
  • Marque a issue como Done ou Canceled, ou atribua-a a alguém que não seja o Comma: a tarefa em andamento termina e o Comma avisa na sessão. Uma tarefa que já entregou o resultado não é alterada.
  • Exclua a issue: a tarefa em andamento termina com uma nota na tarefa dentro do Comma. A sessão some junto com a issue, então nada mais é publicado ali.

Trabalhando no Comma

Toda sessão tem um link Open in Comma, e toda tarefa delegada um link Task in Comma. Lá você lê a transcrição completa, continua o trabalho ou revisa e aceita o resultado. O que você escreve no Comma fica no Comma; só as respostas do Comma ao que foi perguntado no Linear voltam para a issue.

Gerenciar ou desconectar

  • Tudo isso fica no menu Gerenciar do cartão do Linear.
  • Reconectar, após uma confirmação, se o seu login do Linear mudou.
  • Desconectar desvincula só a sua conta. Os colegas mantêm as deles.
  • Remover da organização só aparece para o workspace do Comma que instalou o Comma lá. Um administrador do Linear também pode removê-lo no Linear, em Settings, Applications.
Tema