Skip to content
Browse documentation

Getting started

Remote: control Vopit from your phone

Follow your agents, send requests, answer permissions, and run the Board, Cranks and meetings from vopit.fr/remote.

Vopit Remote is a web app for your phone, at vopit.fr/remote. Signed in with your Vopit account, it lists every Vopit open on your computers (each window, and each engine started by the vopit command) and lets you follow and drive them: see the agents at work, send a request, answer a permission, plan on the Board, run a Crank or hold a meeting. The work still runs on your computer; the phone is a remote control.

Turn Remote on

  1. In Vopit, open Settings → Remote and choose Turn on next to Remote control. The status shows Linked once the link is up. Remote is off by default, and the choice applies to every Vopit on this computer.
  2. Or, from a terminal, run vopit remote on. vopit remote alone shows the state of the link.
  3. On your phone, open vopit.fr/remote and sign in with the same Vopit account. Your open Vopits appear within a few seconds, with the computer, the project and whether it is a window or a terminal engine.
  4. Repeat on each computer you want to follow. Each one must be signed in to Vopit with an active license.
Remote from the terminal
vopit remote                        # state of the link
vopit remote on                     # follow and drive from the web
vopit remote on --approvals --yes   # also answer permissions from the web
vopit remote on --no-approvals      # permissions back to this computer only
vopit remote off                    # turn the link off

What you can do from your phone

WhereWhat you can do
The list of your VopitsSee each Vopit open on your computers: its project, its computer, how many agents are working and whether one needs you. A Vopit that loses its link stays listed as Offline for a few minutes.
ActivitySee the agents with their faces and what each one is doing. Open a request to read its prompt, its result and its steps. Send new work with Ask the team; cancel, retry or resume a request; pause or resume the whole queue.
Waiting for youAnswer the questions agents ask you: pick an option, write your own answer, or skip to let the agent decide. Answer the permissions they ask for, with Approve once or Deny, when web approvals are on for that computer (see below).
Speed modeSwitch the team between Ultra-fast, Balanced and Big brain.
BoardRead the cards by column, add a card to the backlog, start a card as a request, and turn auto-run on or off so the team picks up ready cards by itself.
CranksSee each Crank and its last run, and run it. A Crank that acts outside (posts, sends or publishes) asks you to confirm first.
MeetingsStart a meeting with the agents you choose and chat with them live; write @Name to speak to one agent. Stop the replies, end the meeting, capture its outcomes, then apply or dismiss each one: an applied action becomes a Board card.

Each action runs on your computer with the same checks as in the window: your license, the project and each agent’s permissions. Sending work, writing in a meeting or starting one needs a project open with a team.

Answer permissions from your phone

Answering permissions from the web is a second switch, separate from Remote and off by default. While it is off, the phone shows what an agent asks for, and the request waits until you answer on the computer.

  1. In Settings → Remote, with Remote on, turn on Answer permissions from the web. From a terminal: vopit remote on --approvals --yes; --yes confirms that the web may approve actions on this computer.
  2. On your phone, a pending permission appears under Waiting for you, with the agent, the action (for example the command to run) and its request. Choose Approve once or Deny.
  3. To answer on the computer only again, turn the option off, or run vopit remote on --no-approvals. Turning Remote off turns it off too.

How the link stays safe

  • Nothing reaches your computer from the internet. Each Vopit opens its own connection out to vopit.fr: there is no port to open and no incoming connection.
  • The link uses the signed session of this computer, the one created when you signed in to the app, and needs an active license. The site checks it again every minute and cuts the link when you sign out, remove the computer from your account or lose your license.
  • The phone uses your web session on vopit.fr, and every action it sends is protected against requests forged by other sites.
  • The site receives only a short summary: project and computer names, request titles and statuses, what each agent is doing, and pending permissions. No file paths, no file contents, no keys. The prompt and the result of a request travel only when you open that request on the phone, and shortened.
  • Only a fixed list of actions exists, and your computer carries out each one with the same checks as its window.

Troubleshooting

What you seeWhat to check
A Vopit is not listed, or “No Vopit linked yet”On that computer: Settings → Remote shows Linked (or run vopit remote); Vopit is signed in to the same account as your phone; the license is active (Settings → Account); and Vopit is up to date: Remote needs a version of the app that includes it (Settings shows a Remote tab). A Vopit is listed only while it runs: after you close it, it shows Offline, then disappears.
Settings → Remote shows Not linked, or an errorSign in again in Settings → Account, check your license, and check that the computer can reach vopit.fr. On a company network, see App updates and corporate networks. The link retries by itself, waiting up to a minute between attempts.
A tab is missing (Board, Cranks or Meetings), or agents have no faceThat Vopit runs an older version: the web app only shows what it supports. Update Vopit, then restart it.
Approve once is not offeredWeb approvals are off on that computer. Answer there, or turn on Answer permissions from the web in its Settings → Remote.
An action is refused with a messageYour computer refused it, as its window would; for example “Stop the request before retrying”. Follow the message.
The Vopit does not answerThe computer may be asleep or offline. Each action waits up to 30 seconds for an answer.

All documentation