What is AiServa Desktop?expand_more
AiServa Desktop is the AiServa AI Agent as an app on your own computer. It is built on the open-source OpenCode project (MIT licence), signs in to your AiServa organisation, and uses your organisation's models, knowledge bases, memory and tools, plus files in a folder you open on your computer.
Does AiServa Desktop store API keys on my laptop?expand_more
No. The app never holds provider keys, email passwords or MCP server keys. It holds only a device token that you or an admin can revoke. Every model call goes through your organisation's AiServa gateway, which keeps the keys on the server.
How do I sign in?expand_more
The app shows a short one-time code. You open the AI Workspace, sign in with your password and two-step code as usual, and approve that device. The code is valid for 10 minutes. After approval the device stays signed in for up to 400 days while it is used, and can be revoked at any time.
Can the AI read every file on my computer?expand_more
No. Local tools only work inside the Workspace folder you open in the app, and the local app server listens only on 127.0.0.1, so nothing on your network can reach it.
What is the difference between Simple Mode and Developer Mode?expand_more
Simple Mode is the default and centres on documents, knowledge bases and files. Developer Mode adds the coding interface, such as a terminal and file changes. Your organisation's admins decide which modes are allowed, and each person switches in Settings.
Which systems does AiServa Desktop run on?expand_more
macOS on Apple silicon and Intel, Windows (64-bit) and Linux (AppImage or .deb). Downloads for each system are listed in the AI Workspace as releases become available.
How do I install it?expand_more
Sign in to the AI Workspace and open Profile > Download. Copy the one-line command for your system into Terminal (macOS) or PowerShell (Windows), or download the installer file. The installer checks the file's SHA-256 fingerprint and installs nothing if it does not match.
Can the AI use my computer, not just my files?expand_more
Yes, if your organisation allows it, through two separate tools. The Browser Controller opens its own browser window. The Computer Controller sees your screen and uses the mouse and keyboard for a task you gave it. Each has its own permission, a banner while it works and a Stop button, and your organisation can switch either one off.
What is the difference between the Browser Controller and the Computer Controller?expand_more
The Browser Controller works only inside a browser window of its own (Google Chrome or Microsoft Edge, in a separate AiServa profile) and only on public websites. The Computer Controller works on the whole screen of your computer, in any app, so it also needs a model that can read images and, on a Mac, your permission for Screen Recording and Accessibility. Roles, Rules and audit are set for each separately.
How do I stop the AI while it is using my computer?expand_more
Press Stop in the banner that shows while it works, press Ctrl+Alt+Shift+K (Ctrl+Option+Shift+K on a Mac), or choose Stop Computer and Browser Controllers in the AiServa menu. Every task that used them is stopped, and new actions are refused for 45 seconds.
What does the Computer Controller need on a Mac?expand_more
macOS asks you to allow AiServa Desktop under Privacy and Security, in Screen Recording and in Accessibility. The Computer Controller window in the AiServa menu shows what is still missing and opens each page for you. The Browser Controller needs only Google Chrome or Microsoft Edge.
How do updates work?expand_more
Updates install by themselves while the app is idle, or when you quit. After one, a What's New window opens and lists what changed, with the earlier updates below it. You can open it again from the AiServa menu. Each update is checked against a signature before it is installed.
Do my tasks sync with the AI Workspace?expand_more
Yes. Tasks sync both ways, so a task started on the desktop can be continued in the AI Workspace or on your phone, and the other way round.