Skip to main content
Actualyze AI LogoActualyze AI Logo
All integrations
Actualyze logo

Actualyze Desktop

Actualyze AI

The Actualyze app for macOS and Windows. It opens your coding agents and AI apps through Actualyze, on the budget you choose.

Desktop and chat appsOpenAI Chat CompletionsOpenAI ResponsesAnthropic MessagesOfficial appTech preview

Actualyze Desktop opens the AI apps and coding agents you already use, such as Claude Code, Codex, Claude Desktop and VS Code Copilot, and sends their requests through Actualyze. You sign in once with your organization's sign-in. From then on each app reaches your team's models on the budget you choose. Most apps never need an API key copied into them.

Actualyze Desktop is a tech preview, so it will change as we hear from the people using it. Tell us what works for you and what doesn't.

#Before you start

  • An Actualyze account in a workspace, on at least one team with a budget you can charge.
  • A Mac with Apple silicon on macOS 14 or later, or a Windows 11 PC.
  • The apps you want to use. Actualyze opens and sets up apps you've already installed.

#Install

#macOS

  1. Choose Download for macOS at the top of this page and open the disk image.
  2. Drag Actualyze onto Applications.
  3. Open Actualyze from Applications. It's notarized by Apple, so macOS asks once whether to open it.

Keep Actualyze in Applications, because the apps you set up run a helper inside /Applications/Actualyze.app. Opened from anywhere else, it offers to move itself there.

#Windows

  1. Choose Download for Windows at the top of this page and run the installer. It installs for your user account and is signed by ActualyzeAI, Inc.
  2. If Windows says it protected your PC, choose More info, check that the publisher is ActualyzeAI, Inc., then choose Run anyway.

#Updates

The download buttons always serve the newest version. Once installed, Actualyze keeps itself current. It checks for a new version when it starts and every six hours, downloads it in the background and shows Restart to update in the status bar once it's ready. To check right away, choose Check for updates in the account menu under your initials.

#Sign in

  1. Open Actualyze and choose Continue in browser.
  2. Your organization's sign-in opens in your browser. Sign in, check that the browser shows the same code as Actualyze, then approve.
  3. If you belong to more than one workspace, pick one. If Actualyze asks for a default budget, pick the one most of your work should be charged to.

The sign-in lasts 30 days. A banner asks you to sign in again a week before it ends. Signing in again keeps your apps set up. Actualyze keeps the sign-in in the macOS Keychain or the Windows Credential Manager. None of the apps it opens ever holds it.

#Launch your coding agents

Pick an agent in the dock, pick a folder and choose Launch. Actualyze opens your terminal in that folder and starts the agent with access made for that run alone, charged to the budget on its Charged to line. When the agent exits, Actualyze ends that access. Access that sits unused ends on its own too.

The Actualyze Desktop window. A dock of apps runs across the top with Claude Code selected. Below it, Claude Code's stage shows it running in acme-payments-service, charged to Platform Engineering FY26 Q4, with four recent folders to launch in and a Launch in acme-payments-service button.The Actualyze Desktop window. A dock of apps runs across the top with Claude Code selected. Below it, Claude Code's stage shows it running in acme-payments-service, charged to Platform Engineering FY26 Q4, with four recent folders to launch in and a Launch in acme-payments-service button.
Claude Code's stage, with its recent folders and the budget its runs are charged to.

The stage keeps your four most recent folders for each agent, so the launch you make every day is one click or Enter. ⌘K (Ctrl+K on Windows) finds any app by name. On a Mac, Actualyze opens Terminal, iTerm2, Ghostty, WezTerm or Warp, whichever you choose in Settings. On Windows it opens Windows Terminal.

A launch always reaches Actualyze on the budget you chose. If your own settings point the agent somewhere else, the launch overrides them for that run and tells you which setting it overrode. If a setting your administrator manages points the agent at another provider, the launch stops and names that setting.

One Claude Code run open beside its stage. The panel shows the run's folder, that it is charged to Platform Engineering FY26 Q4, that its access ends after 12 hours without use and that the launch overrode ANTHROPIC_BASE_URL in ~/.claude/settings.json for this run. A Revoke access button sits at the top.One Claude Code run open beside its stage. The panel shows the run's folder, that it is charged to Platform Engineering FY26 Q4, that its access ends after 12 hours without use and that the launch overrode ANTHROPIC_BASE_URL in ~/.claude/settings.json for this run. A Revoke access button sits at the top.
One run's folder, its budget, when its access ends and the setting the launch overrode.

Claude Code and Codex can also get access when you start them yourself. After you choose Set up on their stage, plain claude or codex in any terminal asks Actualyze for access while Actualyze is running.

#Set up your desktop apps once

Desktop apps such as Claude Desktop, ChatGPT, VS Code Copilot, Cline and Zed are set up once from their stage. Set up lists what it will change and every file it will touch before it writes anything. From then on the app asks Actualyze for access whenever it needs it, so Actualyze turns on Start at login to be there when it does. A few apps, such as VS Code Copilot, Zed and JetBrains AI, reach Actualyze through a local connection on your computer. For those, guided steps have you paste a local key that works only through Actualyze on that computer.

Claude Desktop's stage. Under its name the status line reads Set up 12 Oct, last used 10:40, 2 files changed. It is charged to Platform Engineering FY26 Q4, with Show Claude Desktop and Restore Claude Desktop's settings buttons.Claude Desktop's stage. Under its name the status line reads Set up 12 Oct, last used 10:40, 2 files changed. It is charged to Platform Engineering FY26 Q4, with Show Claude Desktop and Restore Claude Desktop's settings buttons.
Claude Desktop, set up and open, with the budget it's charged to.

The files changed link under the app's name opens Changes, a diff of everything Actualyze wrote into the app's settings. Restore settings puts those settings back the way they were and ends the app's access. Your own edits to the same files stay.

Changes open beside Claude Desktop's stage, showing a diff of the inferenceModels list Actualyze added to Claude Desktop's configuration file, with a Show in Finder link.Changes open beside Claude Desktop's stage, showing a diff of the inferenceModels list Actualyze added to Claude Desktop's configuration file, with a Show in Finder link.
Changes, with the setting Actualyze added to Claude Desktop's configuration.

Cursor and Warp send their requests from the vendor's servers, so Actualyze can't reach them that way. For those two, Actualyze makes an API key and walks you through pasting it into the app. These keys follow the same rules as persistent access.

#Choose what each app is charged to

Every launch is charged to a team and a budget. Actualyze uses the first of these that's set.

  1. A budget you pick for one launch. Hold Option (Shift on Windows) and Launch becomes Launch with a different budget…, which asks for the folder, team and budget of that launch.
  2. An .actualyze.toml file in the project folder.
  3. The app's own budget, set with Change on its Charged to line.
  4. Your default budget, in the account menu under your initials.
The Launch Claude Code popover over Claude Code's stage, with Folder acme-payments-service, Team Platform Engineering and Budget Platform Engineering FY26 Q4, a Remember for this app checkbox, then Cancel and Launch buttons.The Launch Claude Code popover over Claude Code's stage, with Folder acme-payments-service, Team Platform Engineering and Budget Platform Engineering FY26 Q4, a Remember for this app checkbox, then Cancel and Launch buttons.
One launch with its own folder, team and budget.

The file lets a repository carry its own budget, so everyone who launches an agent in it charges the same one. A file that names only a team uses that team's default budget.

.actualyze.toml
[start]
team = "Platform Engineering"
budget = "Platform Engineering FY26 Q4"

#See what's running

Activity (⌘J, or Ctrl+J on Windows) lists every app running with access from this computer, the API keys your apps keep and the last 30 days of runs, each with the reason it ended. Revoke access in a run's menu ends its access at once.

Activity open beside Claude Code's stage. Running now lists Claude Code, Claude Desktop and codex in Terminal with 2 running. Earlier lists past runs with how each ended, such as Ended when Claude Code quit.Activity open beside Claude Code's stage. Running now lists Claude Code, Claude Desktop and codex in Terminal with 2 running. Earlier lists past runs with how each ended, such as Ended when Claude Code quit.
Activity, with what's running now and how earlier runs ended.

Actualyze also lives in the macOS menu bar, or the notification area on Windows. Its menu lists what's running and launches your ready apps without opening the window.

#Keep an app working while Actualyze is quit

Most apps get access only while Actualyze is running. For an app that has to keep working while Actualyze is quit, choose Persistent on its Access line. Actualyze gives the app an API key of its own, bound to the app's team and budget. The stage shows when the key expires and asks you to renew it before then. You can also set a monthly limit on the key, so one app can't spend the whole budget.

Kilo Code's stage with its Access line set to Persistent. The status line reads Set up 27 Oct, key expires 26 Nov, 1 file changed. A Monthly limit field shows No limit.Kilo Code's stage with its Access line set to Persistent. The status line reads Set up 27 Oct, key expires 26 Nov, 1 file changed. A Monthly limit field shows No limit.
Kilo Code on Persistent access, with its key's expiry and monthly limit.

On a Mac nobody manages, you choose Persistent app by app. On Windows or on a Mac your organization manages, your administrator decides which apps may use it and how long their keys last. Claude Code, Codex, Claude Desktop, ChatGPT and Hermes Agent offer Persistent on a Mac only.

#For administrators

You can manage Actualyze Desktop through your device management tool, with a managed-preferences profile on macOS or the policy registry on Windows. A policy can limit which apps members use, allow or forbid persistent API keys and set how long they last, give those keys a default monthly limit and turn off automatic updates if you roll out versions yourself. Anything a policy sets shows as Set by your organization in the app. Contact us for the policy reference.

#Apps it works with

What Actualyze doesApps
Launches them in your terminalClaude Code, Codex, OpenCode, Pi, Hermes Agent, Kilo CLI, Junie CLI, Aider, Copilot CLI, goose and Qwen Code
Sets them up once, then you open themClaude Desktop, ChatGPT, VS Code Copilot, Cline, Kilo Code, Continue, OpenCode Desktop, Zed, goose Desktop, Jan, JetBrains AI and Factory Droid
Makes an API key for you to pasteCursor and Warp

For an app Actualyze doesn't know, Add app defines a custom one from OpenAI-style or Anthropic-style environment variables.

#Troubleshooting

  • A launch doesn't start. The app's status line says why, with the fix beside it, such as choosing another terminal when the one in Settings isn't installed.
  • An app stops working after you quit Actualyze. Apps set up through Actualyze get access only while it runs. Turn on Start at login in Settings, or choose Persistent for that app.
  • On a Mac, Actualyze shows no window after you moved it with a terminal command. Quit it, then drag Actualyze.app into Applications in Finder and open it from there.
  • Anything else. Choose Save support bundle… in the account menu and send it to us with what you did and what happened. The bundle is a file on your computer that Actualyze never uploads.

Need an API key?

Start a trial and create a key in a few minutes, or talk to us about rolling Actualyze out across your teams.