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