Windows app
The Windows app puts the cockpit and a Chromium browser in a single window. It uses the same account and the same agents as the portal.
Quick sign-in
Section titled “Quick sign-in”On the sign-in screen, choose Continue in your browser. Diadems opens your usual browser so it can reuse a session you are already signed in to, or let you sign in. The app then returns to the cockpit automatically with a short, single-use code.
The built-in browser, files and the link to an agent are only available after this sign-in.
Start with Windows
Section titled “Start with Windows”By default, Diadems starts quietly when you sign in to Windows and stays in the notification area. Your agents can then use this PC, your shared folders and Chrome as soon as you are signed in, without you having to open the app. To prevent this, turn off Start with Windows in My account → This PC.
Quick ask
Section titled “Quick ask”Press Ctrl + Alt + D, from any application, to open a small window above your work. Choose the agent, type or dictate your request, then press Enter: Diadems opens a new conversation with that text and sends it. Esc closes the window without sending anything. The same shortcut is in the menu of the Diadems icon in the notification area.
You can change or turn off the shortcut in My account → This PC. If another application already uses it, Diadems asks you to choose a different one.
Screenshot to an agent
Section titled “Screenshot to an agent”Press Ctrl + Alt + S (or choose Screenshot to an agent… in the Diadems icon menu): the screen freezes. Drag the mouse to select an area, press Enter to capture the whole screen, or Esc to cancel. Quick ask then opens with the screenshot attached: write your question if you wish, remove the screenshot with one click on ×, then send. Nothing is sent until you click Send.
The capture is refused when the application in the foreground is one of the excluded apps, for example your password manager. Still check what the selected area shows before you send. You can change or turn off the shortcut in My account → This PC.
Built-in browser
Section titled “Built-in browser”The Browser button opens a work area to the right of the cockpit. You can:
- open several tabs, specific to each conversation: they come back when you restart Diadems (adjustable in the browser settings);
- add a page to your bookmarks with the star in the address bar;
- show or hide the bookmarks bar and search your bookmarks;
- import bookmarks from Chrome, Edge, Brave, Vivaldi or Opera, as well as an HTML file exported from another browser;
- follow, cancel and open downloads from the address bar button, which keeps the last five files;
- drag a finished download into the chat or choose Send to the agent to prepare it as an attachment, without exposing its Windows path;
- type an address or find a page you have already visited using the address bar suggestions;
- go back, go forward and refresh;
- search the page with
Ctrl+Fand move through the results; - set the zoom with
Ctrl++andCtrl+-and return to 100% withCtrl+0; - resize the divider between the chat and the browser;
- open the current page in your default browser.
The usual shortcuts are available: Ctrl+L selects the address, Ctrl+T opens
a tab, Ctrl+W closes it, Ctrl+Shift+T restores it and Ctrl+Tab switches to
the next one. The browser menu also groups tab duplication, copying the address,
search, zoom and opening in the default browser.
The browser has a persistent local profile. You sign in to the sites you need yourself; its cookies and sessions stay on your PC.
Address bar suggestions
Section titled “Address bar suggestions”As you type, the address bar suggests pages from your history and bookmarks,
like Chrome. The most likely address completes directly in the field: Enter
opens it, Tab accepts the completion without opening it and Backspace
removes it. The ↑ and ↓ arrows move through the suggestions, Esc closes
the list. When the text is not an address, the Search for “…” line runs the
search with the engine chosen in the settings. To remove a page from your
history, hover over it and click the cross, or select it and press
Shift+Delete. If no suggestions appear, install the latest update of the
Windows app.
The history is saved and encrypted on your PC only. It does not keep any credentials in an address, error pages, or single-use links (sign-in, password reset, signed link). It is never sent to Diadems or to the agent: only the suggestions matching what you type are shown. Pages opened by the agent in this browser appear in it too. You can pause recording or clear the history from the browser settings.
When a suggestion list, a menu, a panel or a Diadems window opens above the page, the page stays displayed as a still image, in the same place (including in mobile view), until it closes, then becomes interactive again. This image is neither saved nor sent. If the agent is driving the browser in the meantime, its actions and captures apply to the real page, which you find again when the overlay closes.
Ask Diadems about a text
Section titled “Ask Diadems about a text”Select a passage in the cockpit or in the built-in browser, then right-click and choose Ask with Diadems. The app lets you choose the agent and the conversation, then prepares the passage as a quote in the composer. You can add your question before sending it: no request is sent automatically.
The source address, if attached, is limited to the page without parameters or fragment. Cookies, passwords and the rest of the page are never sent by this action.
Bookmarks and the history of the last five downloads also stay on the PC. Their files are protected by your Windows account’s encryption. Local paths and the paths of imported profiles are never sent to the portal, the capsule or the agent. When you add a file to the chat, Electron only issues a temporary, revocable permission to read the chosen file.
Annotate a page
Section titled “Annotate a page”To show an element precisely to your agent, click Annotate in the built-in
browser bar. Hover over the page: the targeted element is outlined in blue.
Click it, then write your comment in the Add a comment… bar that opens next
to it, or dictate it with the microphone. Confirm with Enter.
You can also draw on the page before confirming: a toolbar appears at the top,
with the pen, text, rectangle, ellipse, arrow, eraser, colour and thickness.
Circle an area, draw an arrow or write directly on the page; a drawing alone is
enough, and the comment is then optional. Ctrl+Z and Ctrl+Y undo and redo a
stroke.
Each annotation adds the following to the message in the displayed conversation:
- a capture of the element and its surroundings, where it is outlined and numbered, with your drawings (the capture widens to keep them whole);
- a short quoted reference: the number, the type of element and its label, the page title and address (without parameters or fragment), a CSS path and your comment.
You can annotate several elements before sending: nothing is sent until you
press Send, and you can remove a capture or edit the text in the composer. Esc
cancels the comment in progress; a second Esc, or a new click on
Annotate, leaves the mode.
During annotation, the page does not react to your clicks, but the mouse wheel still scrolls the page and its areas. Password, bank card and single-use code fields are hatched out in the capture, and the value of fields is never included in the reference. You can also annotate a local page or a page on your network, for example a site under development or an internal tool: the agent only receives the capture and the comment you add.
Annotation gives the agent no control of the browser. It requires a recent version of the Windows app: if the Annotate button does not appear, install the latest update.
Display the page as on a mobile
Section titled “Display the page as on a mobile”To work with your agent on the mobile version of a site, click Mobile view in the built-in browser bar (the screen and phone icon, next to Annotate) then choose:
- Mobile · iPhone (393 × 852) or Mobile · Android (412 × 915);
- Tablet · iPad (820 × 1180);
- Custom…, then a width and a height between 240 and 2,560 px;
- Computer to return to the usual display.
The same choice is in the “…” menu, under View.
The page reloads and is laid out as on the device: screen width, pixel density, mobile browser reported to the site, and touch screen. Your mouse acts like a finger: a click is a tap and dragging scrolls the page. If the browser area is smaller than the device, the page is scaled down to fit entirely, centred on a neutral background, and the display percentage is shown.
The Mobile view · 393 × 852 banner, under the address bar, reminds you which device is displayed. Rotate switches between portrait and landscape without reloading the page, Size changes a custom size and Exit returns to the computer view: the page reloads exactly as before.
The view belongs to each tab and lasts as long as it stays open; it is not kept after the app restarts. A new tab, including one opened by the agent, is displayed in computer view.
When you let the agent drive, it sees the page as you have chosen it: what it reads from the page includes the device, its clicks are taps and its captures show the mobile view. Only you change the view. You can also Annotate a page in mobile view; selection is then done with the mouse.
This feature requires a recent version of the Windows app: if the Mobile view button does not appear, install the latest update.
Browser settings
Section titled “Browser settings”The gear icon at the far right of the address bar opens the local settings. You can, among other things:
- choose Google, Bing, DuckDuckGo, Qwant, Brave Search or Ecosia for searches typed in the address bar;
- set the home page, the default zoom and whether the bookmarks bar is shown;
- choose to Reopen tabs at start-up: each conversation gets its pages back after a restart. Only addresses are kept, encrypted on the PC; the displayed page loads when the browser opens, the others when you click on them;
- choose the Site appearance: like Windows, always light or always dark, for sites that offer both. Useful when a site displays its dark mode badly;
- turn on the “Do Not Track” signal, block pop-ups and require a Windows confirmation for sensitive permissions (camera, microphone, location…); the dialog names the site making the request and offers Always allow on this site or to remember a refusal;
- review and forget these choices in Security → Site permissions;
- choose the download folder, open it or go back to the default Windows folder;
- pause history recording;
- clear the history, cookies and cache without touching bookmarks or settings.
The settings and the path of the custom folder are encrypted with Windows account protection. Only the folder name is shown in the interface.
Let the agent drive
Section titled “Let the agent drive”On an agent’s page, opening Browser automatically authorises that agent to use the visible area. Close the browser to cut control immediately. This authorisation is tied to the organisation, the agent, the conversation, the user and the device. Changing conversation, agent or organisation, or returning to the list of agents, closes the browser and revokes the authorisation: it is never passed on to the new screen.
Scheduled tasks can use the agent’s isolated, persistent browser. They never inherit interactive control of this Windows browser, which requires its conversation to be displayed and explicitly authorised.
The agent can read the text currently visible, navigate, scroll, fill in an ordinary field or use a target identified on the page. It also sees the list of open tabs and can switch between them; it only closes tabs it opened itself. When a window or pop-up covers the page, this is flagged explicitly and it becomes the only area in which the agent can act.
With the app up to date, the agent can also:
- double-click, right-click (the page’s menu), hover over a menu and drag and drop an element or a slider;
- use Backspace, Delete, Space and the shortcuts that stay within the page, such as Ctrl+A, Ctrl+Z or Ctrl+Enter. It never copies, cuts or pastes: your clipboard stays yours;
- read all the text of a long page without scrolling it;
- attach a file from its workspace to a form (25 MB at most), and save a downloaded file to its workspace rather than to your Downloads folder;
- display the page as on a phone or tablet;
- read a page’s technical messages and its requests, to help fix a site; values that look like secrets are masked;
- record an animated image of what it does, to show you a procedure;
- zoom in on an area of the page to read small text.
If the structure of a page is not enough, the agent can ask for a visual inspection. Safe elements are then outlined in the capture and carry the same reference as in its page reading. These markers are temporary and are removed immediately after the capture.
A Diadems cursor, with the agent’s name, shows its gestures, and a light coloured halo surrounds the browser throughout the control sequence, including when it is observing the page. The cursor glides smoothly from one point to the next, pauses briefly before clicking, shows a ripple on click and follows the element if the page scrolls; your own pointer never moves. If the Windows option that reduces animations is on, its movements are replaced by a brief fade. Tabs always stay visible above this effect. Typing appears gradually in fields, shown by a blinking cursor, instead of inserting the text all at once. The cursor and halo disappear after a short period without action. A brief interruption of the link is reconnected automatically.
The agent never receives cookies, passwords or raw DevTools access. Password fields, file pickers, download links and local network addresses remain blocked. Submitting an ordinary form, with its button or the Enter key, is however no longer blocked: the agent can submit it without further confirmation.
Take control
Section titled “Take control”Under the address bar, a banner shows who is driving the shared browser: The agent is driving or You are in control. During an agent action, it describes it simply, for example “Clicks an element” or “Reads the page”, without showing the text typed or the page content.
- Take control suspends the agent’s access without closing the browser. A sequence in progress stops before its next action and the agent is told that you are driving: it does not retry and tells you what it is waiting for.
- Hand back control gives it access again, for the same conversation and from the same PC. If it has already finished its turn, tell it to continue in the chat.
- Stop the agent interrupts its work in progress in the conversation, like the chat’s stop button.
When a sign-in, two-factor authentication, a CAPTCHA, a payment or the choice of a file is up to you, the agent stops, explains what is needed and asks you to take control and then tell it to continue. It never guesses your credentials and does not keep pushing against the obstacle.
PC link and connection status
Section titled “PC link and connection status”Connect this PC links the computer to your account. The link to the account and the permission to control in a conversation are two separate steps.
Changing agent or conversation does not disconnect the PC from your account. Its name, in the app bar, opens the details of the link; it does not trigger a disconnection. Disconnecting has its own button and a confirmation.
Connecting… refers to the initial check, which can take about twenty seconds. Reconnecting… means Diadems is retrying automatically after an interruption; there is no need to rename or reconnect the computer. No network waits for the connection to return. If Needs checking appears, open the Technical details, then use Try again once you have dealt with the problem.
Allow full control of a PC
Section titled “Allow full control of a PC”Connect this PC links the computer to your account. In a conversation, the PC control button then lets you authorise the chosen computers for that session only. This access is off by default.
Only the session’s pilot can tick their PCs, and the agent only uses them for that pilot’s messages. Other participants with write access see the authorised PCs and their status, but cannot tick them or make the agent act on them; their own PCs have no access in this thread. A change of pilot removes the previous pilot’s PCs.
Access to commands and files requires Diadems Windows 0.1.23 or later. A computer still on an older version is flagged in the list; update the app before entrusting it with a system command.
Once enabled, the agent can control applications and their windows, run PowerShell, read or modify your files and configure software or printers, under the rights of the Windows account running the app. There is no additional Diadems confirmation for each action. This full PC access is separate from the limited browser access described above: the restrictions of that browser are not protection against an action carried out with full PC control.
Knowing whether the PC is reachable
Section titled “Knowing whether the PC is reachable”The conversation’s PC button shows the status of the authorised computers: a green dot when they are online, orange when some are offline, and a crossed-out screen with a red dot when none is reachable. On a narrow screen, the same dot appears on the conversation’s “…” menu. The button label names the computer concerned, for example “DESKTOP-SERVO is offline — open Diadems on this PC”.
If an authorised PC disconnects while you are following the conversation (for example after the Windows app is closed), a discreet message under the header says so, once only; it disappears when the computer comes back. An offline PC stays authorised: the agent asks you to open Diadems on that computer, then to send your request again.
Excluded apps
Section titled “Excluded apps”Some applications stay out of the agent’s reach, even with full control: it does not see them in the list of applications, cannot capture them and never clicks in them. By default, these are password managers (1Password, Bitwarden, Dashlane, KeePass, LastPass…). Add your own in My account → This PC, by name or from the open applications: “Sage” also excludes “Sage 100 Comptabilité”.
This exclusion applies to window control. A PowerShell command, which you authorise separately for a session, is not affected.
Allowed apps
Section titled “Allowed apps”You can also do the opposite: in My account → This PC, tick Only allow these apps and choose them, by name or from the open applications. The agent then sees and controls only these; an excluded application stays excluded. With no application in the list, it controls none.
Watch and stop the agent
Section titled “Watch and stop the agent”While an agent is acting on a PC, a “[Agent] is using [PC]” banner appears under the conversation header, on desktop and on mobile, with a Stop button. On the PC itself, the computer’s name in the app bar shows In use and offers Stop the agent. Stopping cancels the pending action or interrupts the one in progress within a few seconds, then suspends PC control until the next message; it does not disconnect the computer and does not undo effects already produced.
On the PC, the Esc key does the same thing, immediately, while the agent is clicking, typing or capturing a window: you do not need to go back to Diadems. A notification confirms the stop. Outside those moments, Esc keeps its usual role in your applications.
Remove access
Section titled “Remove access”Untick the PC in the session or disconnect it in the app to cut access; the window confirms the removal. Managed commands in progress are stopped, but effects already produced and operations handed to a Windows service are not undone. Disconnecting a PC also removes its authorisations in all your sessions: after reconnecting, authorise it again where useful. Authorisations, removals and stops appear in My account → Security.
A PowerShell command can last up to an hour. The agent follows its status, output and final result from an operation identifier, without rerunning the script to check its progress. It can also ask for it to be stopped. The PC runs one command at a time. Windows administrator confirmations may still require local intervention.
A “Control your PC” or “Share a capture” window comes from the Diadems confirmations in older versions. They are removed for PC control once the session’s access is enabled. Windows/UAC confirmations, permissions requested by a site and the confirmations of the separately entrusted Chrome browser remain distinct.
Add a file
Section titled “Add a file”Sharing a folder directly allows reading, creating, modifying, moving, deleting and the local automations available in that folder, with no “Access level” window and no confirmation per operation. The folder is reconnected automatically for the same session at the next launch; you can revoke this sharing from the chat. Older read or edit shares keep their rights: remove the folder and select it again to grant the new level. This access stays limited to the chosen folder and does not replace enabling the PC for PowerShell and for files located elsewhere.
The folder icon in the conversation actions groups the shared folders, with a counter. Open it to see their status, add a folder, reconnect an offline folder on this PC or remove its access without deleting its files. Selecting the same folder again in the same session no longer adds it twice. Old duplicates on the computer are merged at the next launch of the updated app; two distinct folders with the same name stay separate.
The Files button opens the Windows picker. Only the chosen files receive a temporary local authorisation. They are added to the composer of the current conversation, but are not sent before you confirm.
Notifications and updates
Section titled “Notifications and updates”When the app is not in the foreground, Windows can show replies and events from the Diadems notification centre. A click takes you back to the right page. When the Diadems window is active, the same notification appears instead in a card at the bottom right of the app, never both.
Some notifications carry buttons, for example to reply or decline: they act directly from the Windows notification, without opening the app, and a short notification confirms the result.
When a colleague calls you from the team chat, the app rings even when minimised to the notification area, and Windows shows the call with Answer and Decline as long as the Diadems window is not in the foreground.
Updates are downloaded from Diadems and checked against their signature before installation. When a version is ready, the top bar offers to restart the app to apply it.
The public installer is signed in Diadems’s name. Windows can therefore check its publisher and integrity before installation; do not use a copy whose publisher is unknown.
For IT departments
Section titled “For IT departments”An organisation can enforce certain settings by group policy or script, in the
Windows registry. Diadems reads
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Diadems first, then
HKEY_CURRENT_USER\SOFTWARE\Policies\Diadems; the machine value takes
precedence. Values are read when the app starts.
| Value | Type | Effect |
|---|---|---|
DisableComputerControl |
DWORD 1 | Agents cannot control this PC. |
DisableLocalFolders |
DWORD 1 | No folder can be shared with an agent. |
DisableBrowserAgent |
DWORD 1 | Agents do not drive the built-in browser. |
DisableChromeBridge |
DWORD 1 | The link between Chrome and the agents is cut. |
DisableAutoUpdate |
DWORD 1 | The app no longer checks for updates; your IT department deploys them. |
DisableQuickAsk |
DWORD 1 | Quick ask and its shortcut are disabled, as is screenshot to an agent. |
DisableScreenCapture |
DWORD 1 | Screenshot to an agent and its shortcut are disabled. |
AutoLaunch |
DWORD 0 or 1 | Forces or forbids starting with Windows. |
ExcludedApps |
Multi-string | Applications always excluded from PC control. |
AllowedApps |
Multi-string | Only applications the agents can control (replaces the user’s list). |
These settings are enforced by the app itself, not just hidden. My account → This PC then shows Managed by your organisation and what is enforced. Example, to forbid PC control on a computer:
reg add "HKLM\SOFTWARE\Policies\Diadems" /v DisableComputerControl /t REG_DWORD /d 1 /fDiagnostic logs
Section titled “Diagnostic logs”If the app closes unexpectedly or freezes, open My account → Windows app → Open the logs. The folder contains the app’s rotating technical log and, when a process has crashed, the corresponding native report. You can send this folder to Diadems support.
These files stay on your PC only. They contain no token, no password and no URL parameters, and are never sent automatically.