Vai al contenuto

Comandi

Ogni comando stampa un testo leggibile, oppure JSON con --json. I comandi che seguono un flusso (events, chat read --follow) stampano un oggetto JSON per riga.

drovio <command> [--json]

Indicare persone e condivisioni

Segnaposto Che cosa indicare
<participant id> Un id ottenuto da drovio participants
<participant> Un id di partecipante, oppure un nome che un solo partecipante ha
<guest> L'id dell'evento admission_requested, l'e-mail dell'ospite, oppure un nome che un solo ospite in attesa ha
<contact> Un'e-mail, oppure un nome che un solo contatto ha
<share id> Da drovio share per le vostre condivisioni, da drovio participants per quelle degli altri

Un nome condiviso da più persone viene rifiutato, con un messaggio che chiede l'id o l'e-mail.

Account

Comando Che cosa fa
drovio status L'account connesso, e se è in corso una sessione
drovio status set <status> Imposta lo stato che vedono i vostri contatti: available, busy, away o invisible. Rifiutato durante una sessione, in cui lo stato è in chiamata fino alla sua fine
drovio mic on, drovio mic off Attiva o disattiva il microfono, come fa il pulsante dell'applicazione

Sessione

Comando Che cosa fa
drovio session Il vostro ruolo (host o ospite), il numero di partecipanti, chi è l'host, se l'host registra
drovio participants Per ogni partecipante: id, nome, privilegi, microfono, se consente alle applicazioni IA di vedere il suo schermo (ai_screen_access) e di mostrargli schede di decisione (ai_cards), e che cosa condivide accanto alla sua condivisione principale
drovio participant restrict <participant> --to <rights> Abbassa i diritti di un partecipante a user o spectator, quando siete l'host. Non li alza mai
drovio participant admit <guest>, drovio participant deny <guest> Fa entrare un ospite dalla sala d'attesa della riunione che ospitate, oppure lo respinge
drovio join <link> Entra in una sessione da un link di riunione o di invito del server dell'applicazione stessa
drovio leave Lascia la sessione, oppure la termina per tutti quando siete l'host

Riunioni

Comando Che cosa fa
drovio meeting create Crea una riunione, oppure riusa quella in corso, e ne stampa il link
drovio meeting link Stampa il link della riunione in corso
drovio meeting end Termina per tutti la riunione che ospitate

Chat e schede di decisione

Comando Che cosa fa
drovio chat read [--since <id>] [--follow] Gli ultimi 100 messaggi della chat della sessione, dopo il messaggio <id> se indicato. --follow continua a stampare i nuovi fino alla fine della sessione
drovio chat send <text> [--code] Invia un messaggio a tutti, contrassegnato come inviato dallo strumento da riga di comando. - legge il testo dallo standard input
drovio ask <to> <text> [--timeout <seconds>] [--all-answers] Mostra una scheda di decisione con Accetta e Rifiuta a un <participant id>, oppure a tutti gli altri (all), poi attende la prima risposta, oppure tutte. 120 secondi per impostazione predefinita, da 10 a 600
drovio notify <to> <text> Mostra una scheda che scompare da sola, fuori dalla cronologia della chat. <to> come per ask

Schermi

Comando Che cosa fa
drovio screen -o <file> [--participant <participant id>] [--share <share id>] Salva l'ultimo fotogramma della condivisione di un partecipante, per impostazione predefinita la condivisione principale dell'host, in PNG, oppure in JPEG quando il file termina con .jpg. Rifiutato a meno che quel partecipante non consenta alle applicazioni IA di vedere il suo schermo
drovio share Che cosa condividete: la vostra condivisione principale e quelle accanto a essa
drovio share sources Gli schermi (indice) e le finestre (id) che potreste condividere
drovio share set screen <index>, drovio share set window <id> Condivide questo schermo o questa finestra al posto di ciò che condividete ora. Se siete l'host, la sessione lo vede subito. Come ospite, iniziate a presentarlo alla sessione. Fuori da una sessione, la vostra prossima sessione lo condividerà
drovio share add screen <index>, drovio share add window <id> Lo condivide accanto alla vostra condivisione principale, in una sessione
drovio share stop [<share id>] Interrompe una condivisione accanto a quella principale, oppure tutte le condivisioni

Linux con Wayland

Su un desktop Wayland, è il sistema a scegliere che cosa viene condiviso, tramite la propria finestra di dialogo: share sources indica picked_by_system, share set screen e share add screen aprono questa finestra per l'utente, e le finestre non si possono scegliere dalla riga di comando.

Contatti

Comando Che cosa fa
drovio contacts [--query <text>] I vostri contatti, oppure quelli la cui e-mail o il cui nome contiene <text>: e-mail, nome, gruppo, se sono online, il loro stato e a che punto è la richiesta di contatto
drovio contact invite <contact> Invita un contatto online alla sessione che ospitate. Senza sessione, avvia una chiamata vocale: nulla del vostro schermo viene condiviso, e il microfono resta com'è. L'invito squilla per un minuto
drovio contact cancel <contact> Annulla un invito che sta ancora squillando
drovio contact join <contact> Chiede a un contatto in sessione di farvi entrare. Entrate quando accetta
drovio contact accept <contact>, drovio contact decline <contact> Risponde all'invito di un contatto, il che vi fa entrare nella sua sessione, oppure alla sua richiesta di entrare nella vostra
drovio contact add <email> Chiede a qualcuno di diventare vostro contatto
drovio contact approve <contact> Accetta una richiesta di contatto
drovio contact remove <contact> Rimuove un contatto
drovio contact group <contact> <group> Mette un contatto in un gruppo, "" per nessuno

Eventi

drovio events [--since <id>] stampa gli eventi man mano che arrivano, finché l'applicazione non si ferma. Ognuno ha un id, un time e un type: dopo una riconnessione, passate l'ultimo id a --since per ottenere ciò che è stato perso, tra gli ultimi 500.

Tipo Quando
session_started, session_ended Una sessione inizia, con il vostro ruolo, oppure termina
participant_joined, participant_left, participant_changed Qualcuno entra, esce, oppure cambia nome, diritti, microfono, impostazioni IA o condivisioni
chat Un messaggio in chat
admission_requested Un ospite attende di entrare nella riunione che ospitate
contact_invitation Un contatto vi invita, per un minuto
contact_join_request Un contatto chiede di entrare nella vostra sessione, per un minuto
contact_online, contact_offline, contact_status_changed Un contatto si connette, si disconnette o cambia stato. Un contatto invisibile risulta 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"}}

Questo strumento

Comando Che cosa fa
drovio version Le versioni dello strumento e dell'applicazione
drovio agents La guida fornita agli agenti IA che pilotano lo strumento
drovio mcp Esegue il server MCP sullo standard input e output
drovio mcp install Lo registra nei client MCP installati per voi
drovio help L'elenco dei comandi

Codici di uscita

Codice Significato
0 Successo
1 Errore
2 Uso errato
3 Non consentito: l'utente non ha autorizzato lo strumento, oppure un partecipante nega il suo schermo alle applicazioni IA
4 L'applicazione Drovio non è in esecuzione
5 Nessuna sessione

Con --json, un errore stampa il suo codice e un messaggio:

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