A Code session open in Moon Desktop can be continued from your phone or another computer, in the Moon AI Code page: you follow the conversation, write to Moon and answer its permission requests. Moon always works on your computer, in Moon Desktop; the other device only controls this session. Nothing is shared without your approval, given in Moon Desktop.
What you needLink to the What you need section
- An up-to-date Moon Desktop, with the folder open in Code. If Moon CLI, provided by Moon Desktop, is too old, Moon Desktop asks you to update it.
- On the other device, a browser signed in to the same Moon AI account. Remote control always happens from a browser, never from another Moon Desktop.
- A session that is not in No limits mode, in a workspace that does not require Moon Blur.
Start remote controlLink to the Start remote control section
- In Moon Desktop, open the session in Code.
- Open the “Session actions” menu and choose “Control from another device” (“Continue this session from your phone or another browser.”).
- Moon Desktop opens its window “Control this session from another device?”. It says what the other device will see and be able to do, what the mode of the session allows, and how to stop. Click “Control remotely”, or “Cancel”, offered first.
- If Moon Blur is on, a second question follows: “Moon Blur does not mask what the other device sees”. Click “Continue unmasked” only if this conversation can be seen in clear on the other device (see Moon Blur).
The session can then be controlled remotely: the Moon Desktop title bar shows “Remote control on”, and the page says “Reachable from another device. Open Code on Moon AI there, the session is in the list of computers.” Only one session at a time can be controlled in an open folder.
Open the session on the other deviceLink to the Open the session on the other device section
- On the other device, open Code on chat.realmoon.ai, signed in to the same account.
- In the sidebar, your computer is in the list of computers, with the session: open it.
- The page waits for your approval: “Accept this page in Moon Desktop, on the computer. Without an answer within 2 minutes, remote control stops.” Until you accept, it sees nothing of the conversation.
- In Moon Desktop, the window “A page wants to control this session” opens, with the browser Moon AI announces for this page (“Browser announced by Moon AI: Chrome · Android”, for example). Only accept the page you just opened yourself: click “Let it control”, or “Refuse”, offered first. If the Moon Desktop window is hidden, a notification tells you: “A page wants to control a session”.
Once the page is accepted, it shows the conversation and the banner “A session of Moon Desktop, controlled from here. The permission mode changes in Moon Desktop.” The Moon Desktop bar shows “Controlled remotely”, with the browser in control.
One page at a timeLink to the One page at a time section
- Each page that connects asks for your approval in Moon Desktop. Only the page already accepted, coming back with the same browser after a network drop, picks up again without a new question. With another browser, approval is asked again.
- A page that asks while another one is in control does not take over: the accepted page goes on. If you accept the new one, it takes control, and the former one is disconnected.
- If you refuse a page, or without an answer from you within 2 minutes, only that page is turned away: it says that Moon Desktop did not accept it. If no other page is in control, remote control stops.
What the page sees and can doLink to the What the page sees and can do section
Once accepted, the page:
- sees the whole conversation: your messages, Moon’s answers, attached files and command output;
- can write in it, stop Moon and answer permissions for you;
- can, through Moon, have the files of the folder read and, if it allows it, those of other folders of the computer;
- sees the names of your commands and skills.
It does not see the other sessions of the folder. It does not open, rename, archive or delete any of them: the page only controls this session of Moon Desktop.
What it cannot do:
- Change the permission mode: it stays the one of Moon Desktop. The page shows it and follows its changes; if it tries, it is told to change the permission mode in Moon Desktop.
- “Always allow”: never offered remotely, any more than always deny. The page allows once or denies.
- No limits mode: a session in No limits is never controlled remotely. If the session switches to it during remote control, remote control stops.
What a request from the other device triggers depends on the mode of the session, which the confirmation window reminds you of:
| Mode | A request from the other device |
|---|---|
| “Ask” | Moon asks before acting, in Moon Desktop or on the other device, except what you already allowed for always. Undo, redo and going back happen without a question. |
| “Accept edits” | File edits happen without a question. |
| “Autonomous” | It happens without a question, except publishing and a few connector actions (payment, mass sending). |
| “No limits” | Never controlled remotely. |
Your organization’s rules apply as in Moon Desktop.
On both sidesLink to the On both sides section
- Messages: a message sent from the page shows in Moon Desktop, and the other way around. While Moon works, the page says “Moon is working, asked in Moon Desktop”, and Moon Desktop “Moon is working, asked from the other device”.
- Permissions: a request shows in Moon Desktop and on the page, and the first answer wins. Answered on the page, the Moon Desktop window shows “Answered remotely” (“Allowed from the other device (the Code page controlling this session).”). Answered in Moon Desktop, the page shows “Allowed in Moon Desktop” or “Refused in Moon Desktop”.
- Moon’s questions show on both sides.
Moon BlurLink to the Moon Blur section
Moon Blur masks what goes to the models, not what the other device sees: the Code page receives the conversation as it is, unmasked, through the Moon AI servers. When Moon Blur is on, Moon Desktop tells you and asks for an extra approval, “Continue unmasked”. If a conversation holds data you don’t want to see in clear on the other device, don’t control it remotely.
If your workspace requires Moon Blur, the session cannot be controlled remotely, and remote control in progress stops if the workspace starts requiring it.
When remote control stopsLink to the When remote control stops section
Remote control stops:
- when you click “Stop” in the Moon Desktop title bar, “Stop remote control” in its icon menu or in the “Session actions” menu, or “Stop” on the page of the other device;
- when you close the folder or quit Moon Desktop;
- when the session is closed or deleted, when it switches to No limits mode, or when the workspace requires Moon Blur;
- on its own, after 10 minutes without an accepted page, and after 4 hours at most. Putting the computer to sleep does not push these delays back.
Closing the Moon Desktop window does not stop it. A notification says so (“Remote control goes on”: “The window is closed, but the session can still be controlled. Stop it from the Moon Desktop icon.”), and the icon menu shows “Session controlled remotely”. When remote control stops, Moon’s work in progress goes on in Moon Desktop.
NotificationsLink to the Notifications section
- On the other device: if your phone locks or the connection drops while Moon works, Moon AI still tells you when Moon has finished or waits for your permission, through your account’s notifications. When you come back, the page finds the conversation up to date. See Get notified.
- In Moon Desktop: a notification announces each page that asks to take control when the window is hidden, even if you turned the other notifications off, and another one when you close the window during remote control.
A session open in one place onlyLink to the A session open in one place only section
A session open in Moon Desktop is no longer opened a second time elsewhere, for example with moon rc in the same folder: the Code page says where it is open, instead of showing a conversation that no longer moves on. To continue it from another device, use “Control from another device”. See A session open in one place only.
If remote control does not startLink to the If remote control does not start section
- “Control from another device” does not show: update Moon Desktop; it provides the Moon CLI version needed.
- “Remote control not started.”, followed by the reason: the session is in No limits mode, the workspace requires Moon Blur, or another session of this folder can already be controlled.
- The page stays on “Accept this page in Moon Desktop, on the computer.”: go to the computer and accept the page in the Moon Desktop window, within 2 minutes.
- The page says that Moon Desktop did not accept it: the page was refused, or nobody answered in time. Open the session again on the other device and accept it in Moon Desktop.