Ir para o conteúdo

Comandos

Cada comando imprime texto legível, ou JSON com --json. Os comandos que seguem um fluxo (events, chat read --follow) imprimem um objeto JSON por linha.

drovio <command> [--json]

Designar pessoas e partilhas

Marcador O que indicar
<participant id> Um id obtido com drovio participants
<participant> Um id de participante, ou um nome que só um participante tem
<guest> O id do evento admission_requested, o e-mail do convidado ou um nome que só um convidado em espera tem
<contact> Um e-mail, ou um nome que só um contacto tem
<share id> Obtido com drovio share para as suas próprias partilhas, com drovio participants para as dos outros

Um nome partilhado por várias pessoas é recusado, com uma mensagem que pede o id ou o e-mail.

Conta

Comando O que faz
drovio status A conta com sessão iniciada e se uma sessão está a decorrer
drovio status set <status> Define o estado que os seus contactos veem: available, busy, away ou invisible. Recusado durante uma sessão, em que o estado é em chamada até ao fim
drovio mic on, drovio mic off Liga ou desliga o microfone, como o botão da aplicação

Sessão

Comando O que faz
drovio session O seu papel (anfitrião ou convidado), o número de participantes, quem é o anfitrião e se o anfitrião está a gravar
drovio participants O id, o nome, os privilégios e o microfone de cada participante, se deixa as aplicações de IA ver o seu ecrã (ai_screen_access), se aceita cartões de decisão (ai_cards) e o que partilha além da partilha principal
drovio participant restrict <participant> --to <rights> Reduz os direitos de um participante para user ou spectator, quando é o anfitrião. Nunca os aumenta
drovio participant admit <guest>, drovio participant deny <guest> Faz entrar um convidado a partir da sala de espera da reunião de que é anfitrião, ou recusa-o
drovio join <link> Entra numa sessão a partir de uma hiperligação de reunião ou de convite do próprio servidor da aplicação
drovio leave Sai da sessão, ou termina-a para todos quando é o anfitrião

Reuniões

Comando O que faz
drovio meeting create Cria uma reunião, ou reutiliza a atual, e imprime a sua hiperligação
drovio meeting link Imprime a hiperligação da reunião atual
drovio meeting end Termina a reunião de que é anfitrião, para todos

Chat e cartões de decisão

Comando O que faz
drovio chat read [--since <id>] [--follow] As últimas 100 mensagens do chat da sessão, posteriores à mensagem <id> se for indicada. --follow continua a imprimir as novas até ao fim da sessão
drovio chat send <text> [--code] Envia uma mensagem a todos, assinalada como enviada a partir da ferramenta de linha de comandos. - lê o texto da entrada padrão
drovio ask <to> <text> [--timeout <seconds>] [--all-answers] Mostra um cartão de decisão com Aceitar e Recusar a um <participant id>, ou a todos os outros (all), e depois aguarda a primeira resposta, ou todas. 120 segundos por predefinição, de 10 a 600
drovio notify <to> <text> Mostra um cartão que desaparece por si, fora do histórico do chat. <to> como para ask

Ecrãs

Comando O que faz
drovio screen -o <file> [--participant <participant id>] [--share <share id>] Guarda o último fotograma da partilha de um participante, por predefinição a partilha principal do anfitrião, em PNG, ou em JPEG quando o ficheiro termina em .jpg. Recusado se esse participante não deixar as aplicações de IA ver o seu ecrã
drovio share O que partilha: a sua partilha principal e as que estão ao lado dela
drovio share sources Os ecrãs (índice) e as janelas (id) que poderia partilhar
drovio share set screen <index>, drovio share set window <id> Partilha este ecrã ou esta janela em vez do que partilha agora. Como anfitrião, a sessão vê-o de imediato. Como convidado, começa a apresentá-lo à sessão. Fora de uma sessão, a sua próxima sessão vai partilhá-lo
drovio share add screen <index>, drovio share add window <id> Partilha-o ao lado da sua partilha principal, numa sessão
drovio share stop [<share id>] Para uma partilha ao lado da principal, ou todas as partilhas

Linux com Wayland

Num ambiente de trabalho Wayland, é o sistema que escolhe o que é partilhado, através da sua própria caixa de diálogo: share sources indica picked_by_system, share set screen e share add screen abrem essa caixa de diálogo para o utilizador, e as janelas não podem ser escolhidas a partir da linha de comandos.

Contactos

Comando O que faz
drovio contacts [--query <text>] Os seus contactos, ou aqueles cujo e-mail ou nome contém <text>: e-mail, nome, grupo, se estão online, o seu estado e o ponto em que se encontra o pedido de contacto
drovio contact invite <contact> Convida um contacto online para a sessão de que é anfitrião. Sem sessão, inicia uma chamada de voz: nada do seu ecrã é partilhado e o microfone fica como está. O convite toca durante um minuto
drovio contact cancel <contact> Cancela um convite que ainda está a tocar
drovio contact join <contact> Pede a um contacto numa sessão que o deixe entrar. Entra quando ele aceitar
drovio contact accept <contact>, drovio contact decline <contact> Responde ao convite de um contacto, o que o faz entrar na sessão dele, ou ao pedido dele para entrar na sua
drovio contact add <email> Pede a alguém que seja seu contacto
drovio contact approve <contact> Aceita um pedido de contacto
drovio contact remove <contact> Remove um contacto
drovio contact group <contact> <group> Coloca um contacto num grupo, "" para nenhum

Eventos

drovio events [--since <id>] imprime os eventos à medida que chegam, até a aplicação parar. Cada um tem um id, um time e um type: após uma nova ligação, passe o último id a --since para obter o que perdeu, entre os últimos 500.

Tipo Quando
session_started, session_ended Uma sessão começa, com o seu papel, ou termina
participant_joined, participant_left, participant_changed Alguém entra, sai, ou muda de nome, de direitos, de microfone, de definições de IA ou de partilhas
chat Uma mensagem de chat
admission_requested Um convidado aguarda para entrar na reunião de que é anfitrião
contact_invitation Um contacto convida-o, durante um minuto
contact_join_request Um contacto pede para entrar na sua sessão, durante um minuto
contact_online, contact_offline, contact_status_changed Um contacto fica online, fica offline ou muda de estado. Um contacto invisível está offline
{"id":45,"time":"2026-11-07T17:13:58Z","type":"admission_requested","participant":{"id":"0228…","name":"Grace","email":"grace@example.com"}}
{"id":52,"time":"2026-11-07T17:14:46Z","type":"contact_offline","contact":{"email":"alan@example.com","status":"offline"}}

Esta ferramenta

Comando O que faz
drovio version As versões da ferramenta e da aplicação
drovio agents O guia dado aos agentes de IA que comandam a ferramenta
drovio mcp Executa o servidor MCP na entrada e na saída padrão
drovio mcp install Regista-o nos clientes MCP instalados para si
drovio help A lista de comandos

Códigos de saída

Código Significado
0 Sucesso
1 Erro
2 Utilização incorreta
3 Não autorizado: o utilizador não autorizou a ferramenta, ou um participante não deixa as aplicações de IA ver o seu ecrã
4 A aplicação Drovio não está em execução
5 Nenhuma sessão

Com --json, uma falha imprime o seu código e uma mensagem:

{"error":{"code":"not_authorized","message":"This participant does not let AI apps see their screen"}}