Desktop App (Preview)
AdaL Desktop is the native AdaL experience for working on projects in a visual workspace. It gives you a home screen for projects and recent sessions, a chat-first coding workflow, file browsing, and a dedicated review experience for checking changes before you move forward.
AdaL Desktop is currently in preview. The CLI remains the recommended stable interface, while the desktop app is the best place to try the newest native workspace experience.
Why use AdaL Desktop?
Use the desktop app when you want:
- A native GUI app instead of a terminal UI
- A project home screen with recent sessions
- A workspace designed around chat, files, and code changes
- Review Agent flow for undestanding and clustering PRs
- The same AdaL account and agent experience across CLI and Desktop
Supported platforms
AdaL Desktop is available for:
| Platform | Download | Package |
|---|---|---|
| macOS 15 (Sequoia) or later, Apple Silicon (M1 and later) | Download for macOS | .dmg |
| Windows 10 and 11 (x64) | Download for Windows | .exe installer |
| Linux (x64): Debian, Ubuntu and their derivatives | Download for Linux | .deb |
Intel Macs and ARM builds for Windows and Linux are not available yet.
On macOS 13 or 14, AdaL Desktop still opens. A small notice appears in the corner when it starts: Later closes it until the next launch, and Got it stops it for that macOS version. On macOS 13 AdaL cannot save videos as MP4 files (it can still show single frames), and on macOS 14 that is untested. Other features may also fail. To fix this, update macOS in System Settings → General → Software Update, or press How to update in the notice.
Install
https://adal.sylph.ai/download/desktop/get picks the download for the computer you open it on. Each download page starts the download and shows the steps below.
macOS
- Open
AdaL-arm64.dmgfrom your Downloads. - Drag AdaL into Applications.
- Open AdaL from Applications or Launchpad.
Windows
- Open
AdaL-Setup-x64.exefrom your Downloads. - The installer and the app's binaries are code-signed as SylphAI, Inc. If Windows still shows Windows protected your PC — it can warn about a file it has not seen before — click More info, then Run anyway.
- Click Install, then open AdaL from the Start menu.
Linux
-
Download
AdaL-amd64.deb. -
Install it:
cd ~/Downloadssudo apt install ./AdaL-amd64.deb -
Open AdaL from your applications, or run
adal-desktop.
Video projects keep their versions with git. On Linux, AdaL uses the system git, so install it if you do not have it (sudo apt install git). macOS and Windows builds include their own.
Updates
AdaL Desktop updates itself on macOS, Windows and Linux. On Linux it installs the update without asking for your password when you are at the computer. Over SSH or remote desktop, Linux asks for an administrator password instead.
While the app is open it checks for a new version every 10 minutes. When a download finishes you get a dialog — Restart Now installs it, Later installs it the next time you open AdaL. Choosing Later keeps that version quiet, so you are not asked again for it. If a check fails — most often the first one after the computer wakes, before the network is back — AdaL tries again a minute later instead of waiting for the next 10-minute check.
AdaL also checks at launch, before the window opens. When a new version is waiting, a small window says Updating AdaL to v<version>…, then Installing update, hold on…, and AdaL reopens on the new version. That wait has no time limit while the download keeps moving — the macOS update is over 500 MB, so a slow connection can take many minutes. It gives up only when no data has arrived for 30 seconds; then AdaL opens on the version you already have, the download carries on in the background, and you get the usual Restart Now dialog when it finishes. The first launch after a fresh install skips this check, and a version that fails three times at launch is left to the background check.
On Windows and Linux, that dialog waits until you are back in AdaL. If the window is minimized or behind another app, the taskbar button flashes and a notification says AdaL <version> is ready; clicking it brings AdaL forward, and the dialog opens then. On macOS the dialog is attached to the window, so it appears straight away.
Restarting does not leave you looking at an empty desktop. A small Updating AdaL window stays on screen while AdaL closes and is replaced, showing a spinner and "Installing the update. AdaL will reopen automatically." It closes itself once the new version shows its window. The new version opens on a Preparing AdaL… screen until the home screen is ready. This works on macOS, Windows and Linux. On Windows the update installs silently behind that window — no setup wizard to click through — and AdaL reopens by itself, in the folder you installed it in the first time. Windows also unpacks the new version while AdaL is still open, so the restart only swaps two folders instead of copying 1.5 GB with the app closed. If that preparation does not finish, the restart falls back to the full install, which takes a few minutes.
The window comes to the front once when it opens, then behaves like any other window: other apps can cover it, and its taskbar button or Dock icon brings it back. If the install fails, it says so within about a minute — AdaL couldn't finish updating. with an Open AdaL button, or Download AdaL when the old version is no longer on disk. If nothing happens either way, the window closes itself after an hour instead of spinning forever.
You can also check by hand: AdaL → Check for Updates…. The AdaL menu is there on macOS, Windows and Linux, and it holds About AdaL, Check for Updates… and Quit. Every outcome ends in a dialog that says what happened — already up to date, downloading, or ready to restart.
After installing, you can open AdaL Desktop in either of these ways:
- Click the AdaL app icon from your applications menu
- Open AdaL CLI in your project and run
/ide
First launch
When you open AdaL Desktop, you start on the home screen.
From there you can:
- Pick a project folder
- Start a new task from the chat input
- Choose a workflow mode such as coding, research, or video
- Continue work from recent sessions
- Move into a focused workspace for the project
The goal is to make starting work feel closer to opening an IDE: choose a project, describe what you want, and keep the conversation, files, and changes in one place.
Workspace experience
The desktop workspace is designed for everyday development tasks:
- Ask AdaL to explain, edit, debug, or improve code
- Browse project files without leaving the app
- Watch the file tree and any open file update as the agent edits them
- Keep sessions organized by project
- Switch between active work and previous conversations
- Review generated changes visually before deciding what to do next
Typing into the chat box
You do not have to click the chat box first. After a click on a message, a sidebar row, or the empty page, the next letter you type goes into the box and the box takes the focus, with the caret at the end of whatever draft is already there.
Only a plain printable key moves the focus. These stay where they are:
⌘/Ctrlshortcuts, so⌘Cstill copies a selected message.Optionon macOS andAltGron Windows type characters, so they count as typing.Space, which scrolls the conversation and presses a focused button.- Named keys —
Enter,Esc,Tab, the arrows. - Anything typed in a field (search, rename, find) or in a dialog, menu, or list that reads keys itself, such as the approval card's
1/2/j/k.
With a Chinese or Japanese input method, the first key after a click arrives as a plain letter and lands as one; composition starts with the second key.
Attach files and images
There are three ways to put a file in the chat box, and they all do the same thing:
- Paste it with
⌘VorCtrl+V. - Click + (Add files or folders) and pick any files or folders. The system dialog has no format limit.
- Drag a file or folder onto the chat box. The whole box is the drop target, and it shows a ring while the file is over it.
PNG, JPEG, GIF, WebP and SVG attach as images, up to 10 MB each. An image over that limit is skipped with a notice that says so.
Every other file — a .mov, a PDF, a .zip, a TIFF — is attached by its path, and the agent opens it with its own tools. A folder is attached the same way and listed for the agent. Text files are read and quoted in the message; a file the text reader refuses, or whose content is over 1 MB, falls back to the path line.
You can attach while AdaL is still replying. The attachment is held with the message you are typing and sent when that message goes.
Each attached file shows up twice: a numbered tile in the strip above your text, and a chip with the same number inline, at the spot in the text where you added it. The tile's ✕ removes the file and every chip for it; Backspace on a chip removes just that mention. Mentioning one file twice shares a single number and tile, and its content is sent to the agent once, at the first mention.
Message times and copy
Hover a message — one you sent, one still queued, or an answer — and a small row appears with the time it was sent and a copy button. The copy button puts that message's text on the clipboard and turns into a check mark for a second and a half. For your messages it copies what you typed; for an answer it copies the markdown.
The time is written short: 6:32 PM for today, Tuesday 3:19 PM within the last six days, Oct 12 3:19 PM earlier this year, and Oct 12, 2025 3:19 PM for an older year. A chat you reopen keeps its times.
Moving around
The back and forward arrows in the title bar work like a browser's. One history list covers the chats you opened, the new-chat screen, the app's pages (Space, agent setup, GTM, Connectors) and files you opened inside a chat. Help and Subscription open in a pop-up window over the app, so they are not steps.
The arrows, the Go menu and your mouse's side buttons all move through the same list.
| Shortcut (macOS) | Shortcut (Windows, Linux) | Action |
|---|---|---|
⌘[ | Ctrl+[ | Back |
⌘] | Ctrl+] | Forward |
⌘⇧O | Ctrl+Shift+O | New chat |
⌘K | Ctrl+K | Search chats |
⌘⇧S | Ctrl+Shift+S | Show or hide the sidebar |
Pin and rename chats
Chats you keep coming back to can sit at the top of the sidebar, under a Pinned heading, newest pin first, whatever their age. Everything else stays grouped by project folder, and each folder can be folded.
A chat written by a scheduled task carries a clock icon after its title, so it is easy to tell from a chat you started.
Hover a chat row (or focus it with the keyboard) and a ⋮ button appears. Its menu has up to three items:
- Pin / Unpin — move the chat into or out of the Pinned section.
- Rename — turn the title into a text box in place.
Entersaves,Esccancels. - Close chat — the same as
⌘W/Ctrl+W. The chat stays in the sidebar, so you can open it again. This item only shows on a chat that is running in Desktop.
You can also rename from inside the chat: double-click the title in the header, or open the title menu and choose Rename. The name is yours; AdaL does not overwrite it with a generated title afterwards.
The ⋯ button in the chat header opens Session information. Its ✕ closes that card; the chat stays open. Clicking another chat, New Chat or All Chats leaves the old chat running. A chat that is open in Desktop can still be opened in the terminal or continued by a scheduled task: whichever sends a message continues it, and Desktop shows the chat read-only until you send there again. See One chat, open in several places.
A chat you leave keeps its workspace. Open another chat and come back, and the first one looks as you left it: the same panel open, a video paused at the same point, the message list at the same scroll position. The empty chat a folder starts with is the exception — leave it, or cover it with a page such as Schedule or a video, and New Chat opens it clean. The last 10 chats you looked at keep their view; past that, the one you have not seen for longest is rebuilt when you return to it. A chat you closed, or one that failed and you pressed Retry on, also starts fresh.
Pins are kept in ~/.adal/settings.json, so they survive restarts and updates.
Close the window, quit the app
Closing the AdaL window hides it. Every chat keeps running — a long answer or a video being rendered carries on. Clicking the Dock icon, the tray icon, an adal:// link, or launching AdaL again brings back the same window with the same chats, still mid-answer. This is the same on macOS, Windows and Linux.
Quit is the only thing that ends chats: Quit AdaL in the AdaL menu, ⌘Q / Ctrl+Q, or Quit AdaL in the tray menu. It stops every chat's backend first, so nothing is left running.
The first time you close the window on Windows or Linux, a notification says AdaL is still running and points at the tray icon. It is shown once.
On a Linux desktop with no tray support there would be no way back to a hidden window, so there close really closes, and closing the last window quits AdaL.
Settings
Settings open as a pop-up inside the main window, the same frame Connectors uses. You reach it from the chat — /byoak and /model below both open it — and the sidebar lists a Settings entry when dev mode is on (ADAL_DEV_MODE=true). Two pages:
- Account — your AdaL account page, signed in, inside the pop-up.
- 3rd Party Plan — two tabs: ChatGPT subscription and BYOAK. Connect or disconnect a ChatGPT Plus or Pro subscription, and add, enable, disable or remove your own provider API keys.
When a ChatGPT subscription is connected, its tab shows the account email, a badge with the plan, and two usage meters — 5-hour and Weekly — each with the percentage used and when it resets. These numbers come from ChatGPT, not from your AdaL plan. The refresh button next to Disconnect ChatGPT re-reads both the connection and the usage; a successful read is reused for 60 seconds.
Setup inside a chat goes to the same pop-up, so there is one place for these settings:
/byoakopens Settings → 3rd Party Plan → BYOAK./modelopens the model picker; its ChatGPT subscription · Manage in Settings entry opens Settings → 3rd Party Plan → ChatGPT subscription.
See BYOAK and ChatGPT Subscription.
Slash commands
Type / in the chat box to get the same command list as the terminal, filtered as you type. The commands that open a panel in the CLI open one in Desktop too — /model, /mcp, /connector, /permissions, and the rest.
A few are terminal-only on Desktop: /theme, /quit and /about, because the app keeps its own theme setting, ends chats from its own Quit AdaL item, and shows your version and account in its own menus. /resume is not offered either — open another chat from the sidebar instead. See Slash Commands.
Approvals
The row of controls under the chat box has a pill naming the approval mode this chat runs in. Click it to pick another:
| Mode | What it does |
|---|---|
| Ask for approval | Asks before changing files, running risky commands, or acting in your connected apps. |
| Auto Edit | Edits files for you without asking. Still asks before risky commands or acting in connected apps. |
| Full access | Never asks. Changes files, runs any command, and acts in your connected apps on its own. |
Reads, searches, web search and the project's own test, build and lint commands never ask, in any mode.
The mode you pick is kept for that project folder in ~/.adal/settings.json, so the next chat you open on the same folder starts in it instead of asking again. The terminal reads the same setting: an adal session started in that folder restores the saved mode unless you pass --permission-mode or --yolo. Answering "allow always" on a single approval prompt does not change the saved mode, and headless or SDK runs neither save nor restore it.
Connectors
The Connectors page in the sidebar manages the accounts AdaL can use — Gmail and the rest of Google Workspace, Slack, Notion, GitHub, Jira, Stripe and more. Search the list, add an account, and the agent can then work with it. The list loads when you sign in, so the page opens with the cards already drawn, and a returning user sees the previous list straight away.
Two views split the list: Yours shows the services you have an account on, with the count beside the name, and Discover shows the rest. Yours opens first once you have at least one account; otherwise you start on Discover. The search box looks across both views, and picking a view clears what you typed. See Connectors.
Settings, Connectors, chat search, and the platform pages the profile menu opens (Get help, Legal center, Team, Subscription) are all pop-ups inside the main window. None of them opens a second window, so in macOS fullscreen they stay on the same Space as AdaL.
Every pop-up closes on Esc, a click outside it, or its ✕. ⌘W / Ctrl+W closes the top pop-up first; it closes the chat only when no pop-up is open.
Scheduled tasks
Desktop runs prompts at a time you pick — once, or again and again — even with the app closed. It carries its own copy of the scheduler, so you do not need the AdaL CLI installed.
The sidebar's Schedule page, directly under Connectors, lists every task on this computer, as a list or a week calendar. Typing /schedule in a chat opens the same page. From there you can open a task's details and output, pause or resume a repeating one, remove a task, and press Open chat to reopen the chat its runs continue. The page does not add or edit tasks — ask AdaL in a chat for that. Stop and Uninstall are in the terminal's /schedule daemon.
Start and Restart switch scheduling to the copy inside the Desktop app you pressed them in. Opening a different Desktop version does not switch it by itself. See Scheduled Tasks.
Review Agent
AdaL Desktop puts review at the center of the coding workflow. The Review Agent helps you move from “AdaL changed code” to “I understand and trust these changes.”
Instead of reviewing a long list of files one by one, the Review Agent organizes changes into a guided review experience.
Guided PR self-review
Use the Review Agent when you want to review a PR.
It helps you:
- See what files changed
- Compare before-and-after code in a visual diff
- Understand why related changes belong together
- Leave notes on specific parts of a diff
- Track what has been reviewed and what still needs attention
- Ask AdaL to revise or explain changes before you continue
PR clusters
For larger tasks, AdaL groups related edits into clusters. A cluster is a set of changes that should be reviewed together, such as a UI update, an auth change, or a test update.
This makes multi-file work easier to understand because you can review by intent instead of jumping through unrelated files.
To make the cluster, open a PR branch with AdaL Desktop, trigger the review agent in the chat and ask the review agent to make a cluster for the PR.
In a review, you may see:
- Groups of related files
- A guided walkthrough of each group
- A visual sense of how parts of the change depend on each other
- Clear progress as files are confirmed or marked for follow-up
Review notes and comments
While reading a diff, you can select code and leave review notes. This is useful for questions, follow-ups, or issues you want AdaL to address.
Review notes help you:
- Mark something as resolved or unresolved
- Keep feedback attached to the relevant code
- Collect issues before asking AdaL to revise
- Turn review feedback into GitHub PR comments when reviewing a pull request
Authentication
AdaL Desktop uses the same AdaL account system as the CLI interface.
On first use, the app opens your browser. Sign in, or sign up if you do not have an account yet. The browser then shows a consent card that names AdaL Desktop and the account it will connect; press Connect there.
After that the browser shows AdaL Desktop Connected with a Return to AdaL Desktop button, which brings the app window to the front. If nothing happens when you press it, switch to the AdaL window yourself — you are already signed in — and close the browser tab. If sign-in does not go through, the browser shows a failure page instead.
Desktop vs CLI
| Interface | Best for |
|---|---|
| CLI | Fast terminal-native coding, automation, and keyboard-first workflows |
| Desktop | Native project workspace, recent sessions, file browsing, and visual review |
All AdaL interfaces share the same core AdaL experience, so you can choose the interface that best fits the way you like to work.