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.
| 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"}}
| 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"}}