Skip to main content

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, and file browsing.

Preview

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
  • The same AdaL account and agent experience across CLI and Desktop

Supported platforms​

AdaL Desktop is available for:

PlatformDownloadPackage
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 derivativesDownload 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​

  1. Open AdaL-arm64.dmg from your Downloads.
  2. Drag AdaL into Applications.
  3. Open AdaL from Applications or Launchpad.

Windows​

  1. Open AdaL-Setup-x64.exe from your Downloads.
  2. 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.
  3. Click Install, then open AdaL from the Start menu.

Linux​

  1. Download AdaL-amd64.deb.

  2. Install it:

    cd ~/Downloads
    sudo apt install ./AdaL-amd64.deb
  3. 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:

  1. Pick a project folder
  2. Start a new task from the chat input
  3. Choose a workflow mode such as coding, research, or video
  4. Continue work from recent sessions
  5. 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

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:

  • ⌘/Ctrl shortcuts, so ⌘C still copies a selected message. Option on macOS and AltGr on 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 ⌘V or Ctrl+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
⌘⇧OCtrl+Shift+ONew chat
⌘KCtrl+KSearch chats
⌘⇧SCtrl+Shift+SShow 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. Enter saves, Esc cancels.
  • 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 below opens it — and the sidebar lists a Settings entry when dev mode is on (ADAL_DEV_MODE=true). Three pages:

  • Account — your AdaL account page, signed in, inside the pop-up.
  • Models — a read-only list of the models AdaL can reach, with tabs for Chat, Video, Image and Audio. Each row is a model's name, its one-line note from the catalog, and Default on the one the agent starts with. No prices. Chat has the most models, so it folds them by provider with a count on each row. You pick a chat model in the input box, not here; the agent picks the video, image and audio model itself unless you name one in your prompt.
  • 3rd Party Plan — one page with two cards, ChatGPT subscription and API keys. Connect or disconnect a ChatGPT Plus or Pro subscription, and add, enable, disable or remove your own provider API keys. These apply to the main agent only: subagents and the audio, image and video models still run on your AdaL plan.

When a ChatGPT subscription is connected, its card 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.

Two commands set these up from inside a chat:

  • /byoak opens Settings → 3rd Party Plan, scrolled to the API keys card.
  • /model opens the composer's Model section, the same one the Model button under the chat box opens. Its ChatGPT Subscription box connects a subscription; the Disconnect row there opens Settings → 3rd Party Plan.

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.

Work folder​

The first button in the row under the chat box is Work folder, naming the folder this chat runs in. Pressing it opens the folder list inside the chat box: the current folder with its full path, up to 5 Recent projects, and Open another folder…, which opens the system folder dialog. The same button, Esc, or a click outside the chat box closes it again.

On a new chat, picking a folder moves that chat to it. On a chat that already has messages, the folder is fixed — the list says so, and picking a folder starts a new chat there instead.

Approvals​

The Approvals button under the chat box names the mode this chat runs in — Ask first, Auto edit or YOLO. Press it to pick another:

ModeWhat it does
Ask for approvalAsks before changing files, running risky commands, or acting in your connected apps.
Auto EditEdits files for you without asking. Still asks before risky commands or acting in connected apps.
YOLONever 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.

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​

InterfaceBest for
CLIFast terminal-native coding, automation, and keyboard-first workflows
DesktopNative project workspace, recent sessions, and file browsing

All AdaL interfaces share the same core AdaL experience, so you can choose the interface that best fits the way you like to work.