Skip to content

Commands

Every command prints readable text, or JSON with --json. Commands that follow a stream (events, chat read --follow) print one JSON object per line.

drovio <command> [--json]

Naming people and shares

Placeholder What to give
<participant id> An id from drovio participants
<participant> A participant id, or a name only one participant has
<guest> The id of the admission_requested event, the guest's email, or a name only one waiting guest has
<contact> An email, or a name only one contact has
<share id> From drovio share for your own shares, from drovio participants for the others'

A name shared by several people is refused, with a message asking for the id or the email.

Account

Command What it does
drovio status The signed-in account, and whether a session runs
drovio status set <status> Sets the status your contacts see: available, busy, away or invisible. Refused during a session, where the status is in call until it ends
drovio mic on, drovio mic off Turns the microphone on or off, as the app's button does

Session

Command What it does
drovio session Your role (host or guest), the number of participants, who hosts, whether the host records
drovio participants Each participant's id, name, privileges, microphone, whether they let AI apps see their screen (ai_screen_access) and take decision cards (ai_cards), and what they share beside their main share
drovio participant restrict <participant> --to <rights> Lowers a participant's rights to user or spectator, when you host. Never raises them
drovio participant admit <guest>, drovio participant deny <guest> Lets a guest in from the waiting room of the meeting you host, or turns them away
drovio join <link> Joins a session from a meeting or invite link of the app's own server
drovio leave Leaves the session, or ends it for everyone when you host

Meetings

Command What it does
drovio meeting create Creates a meeting, or reuses the current one, and prints its link
drovio meeting link Prints the link of the current meeting
drovio meeting end Ends the meeting you host, for everyone

Chat and decision cards

Command What it does
drovio chat read [--since <id>] [--follow] The last 100 messages of the session chat, after message <id> if given. --follow keeps printing new ones until the session ends
drovio chat send <text> [--code] Sends a message to everyone, marked as sent from the command-line tool. - reads the text from the standard input
drovio ask <to> <text> [--timeout <seconds>] [--all-answers] Shows a decision card with Accept and Refuse to a <participant id>, or to all the others, then waits for the first answer, or every one. 120 seconds by default, 10 to 600
drovio notify <to> <text> Shows a card that goes away by itself, outside the chat history. <to> as for ask

Screens

Command What it does
drovio screen -o <file> [--participant <participant id>] [--share <share id>] Saves the last frame of a participant's share, the host's main share by default, as PNG, or JPEG when the file ends in .jpg. Refused unless that participant lets AI apps see their screen
drovio share What you share: your main share and those beside it
drovio share sources The screens (index) and windows (id) you could share
drovio share set screen <index>, drovio share set window <id> Shares this screen or window in place of what you share now. Hosting, the session sees it at once. As a guest, you start presenting it to the session. Outside a session, your next session will share it
drovio share add screen <index>, drovio share add window <id> Shares it beside your main share, in a session
drovio share stop [<share id>] Stops one share beside the main one, or every share

Linux under Wayland

On a Wayland desktop, the system picks what is shared, through its own dialog: share sources reports picked_by_system, share set screen and share add screen open that dialog for the user, and windows cannot be chosen from the command line.

Contacts

Command What it does
drovio contacts [--query <text>] Your contacts, or those whose email or name holds <text>: email, name, group, whether they are online, their status and where the contact request stands
drovio contact invite <contact> Invites an online contact to the session you host. Without a session, starts a voice call: nothing of your screen is shared, and the microphone stays as it is. The invitation rings for a minute
drovio contact cancel <contact> Cancels an invitation still ringing
drovio contact join <contact> Asks a contact in a session to let you in. You join when they accept
drovio contact accept <contact>, drovio contact decline <contact> Answers a contact's invitation, which joins their session, or their request to join yours
drovio contact add <email> Asks someone to be your contact
drovio contact approve <contact> Accepts a contact request
drovio contact remove <contact> Removes a contact
drovio contact group <contact> <group> Puts a contact in a group, "" for none

Events

drovio events [--since <id>] prints the events as they come, until the app stops. Each one has an id, a time and a type: after a reconnection, pass the last id to --since to get what was missed, among the last 500.

Type When
session_started, session_ended A session starts, with your role, or ends
participant_joined, participant_left, participant_changed Someone joins, leaves, or changes name, rights, microphone, AI settings or shares
chat A chat message
admission_requested A guest waits to enter the meeting you host
contact_invitation A contact invites you, for a minute
contact_join_request A contact asks to join your session, for a minute
contact_online, contact_offline, contact_status_changed A contact comes online, goes offline or changes status. An invisible contact is 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"}}

This tool

Command What it does
drovio version The versions of the tool and of the app
drovio agents The guide given to AI agents driving the tool
drovio mcp Runs the MCP server on the standard input and output
drovio mcp install Registers it in the MCP clients installed for you
drovio help The list of commands

Exit codes

Code Meaning
0 Success
1 Error
2 Wrong usage
3 Not allowed: the user has not allowed the tool, or a participant keeps their screen from AI apps
4 The Drovio app is not running
5 No session

With --json, a failure prints its code and a message:

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