Skip to main content

Install

Celeris ships for macOS, Windows and Linux. Download the build for your platform, install it like any other app, then grant the operating-system permissions it needs and sign in. The standalone Android app is being prepared for its first public store release.

macOS​

  1. Download the macOS build and drag Celeris into /Applications.
  2. Launch it from Spotlight or the Applications folder.
  3. Grant Screen Recording when macOS asks (System Settings → Privacy & Security → Screen Recording). Celeris captures the screen behind the hotkey with it. Without it, the capture comes back blank.
  4. Grant Accessibility if you want Celeris to read the frontmost app name and window title. That is how it knows which window you meant.

Both permissions are per-app, and you can revoke either one at any time in System Settings.

Homebrew​

On Apple silicon, Homebrew can provide the initial signed installation:

brew install --cask ai-celeris/tools/celeris-dash

Use ai-celeris/tools/celeris-dash@beta or ai-celeris/tools/celeris-dash@nightly for a prerelease channel. The cask provides the initial signed installation. The signed Celeris bundle independently checks for later updates and offers Download; Homebrew can also replace the bundle during brew upgrade when its bundle metadata is older. After the download finishes, choose Restart to install the update; Celeris does not install updates in the background. A prerelease cask selects its matching channel on first launch, while an explicit choice in Settings → Updates is preserved.

Windows​

  1. Run the installer and launch Celeris from the Start menu.
  2. Windows may show a SmartScreen prompt the first time you run a newly published build. Choose More info → Run anyway if you trust the publisher shown.

Nothing else needs granting. Screen capture works out of the box.

Linux​

If you have Homebrew, that is the shortest route:

brew install ai-celeris/tools/celeris-dash

That puts a celeris-dash command on your PATH. Run it from a terminal or your launcher. For a prerelease channel install ai-celeris/tools/celeris-dash-beta or ai-celeris/tools/celeris-dash-nightly instead; those give you celeris-dash-beta and celeris-dash-nightly, so you can keep more than one channel side by side.

Without Homebrew, the install script does the same job:

curl -fsSL https://app.celeris.ai/install.sh | bash

It downloads the Linux build, checks it against the published checksum, and adds a launcher entry. Set DASH_CHANNEL=beta or DASH_CHANNEL=nightly before running it to follow a prerelease channel.

Either way you end up with a single self-contained application file. There is nothing to unpack and nothing else to install.

One difference worth knowing: Celeris cannot read where the frontmost window sits on Linux, so a suggested action appears in its own window rather than beside the one it applies to. Everything else works the same.

Android​

The standalone Android release is pending. It will let you chat with Celeris-1 on your phone. See Chat on your phone for the features and release status.

Remote sessions still use the Android companion to control a paired computer. That companion does not run the work on your phone.

An iPhone version is not out yet.

Sign in​

Onboarding asks for no credentials. It explains what Celeris does, optionally takes your role so the starter tools fit your work, and drops you into the app. You can explore before signing in.

When you are ready, choose Connect Celeris account. Celeris shows a short pairing code and holds it on screen for a couple of seconds so you can copy or read it, then opens your browser at the Celeris Console. Type the code there to approve the connection. Celeris issues the key and stores it in your operating system's keychain. You never paste an API key, and the key is never shown to the app's interface.

Celeris never puts the pairing code in the URL it opens. A link that fills the code in for you did not come from Celeris. Typing it yourself is what proves the browser is approving this computer.

To sign in later or switch accounts, use Settings → Account.

Keep it up to date​

The desktop app checks for updates and offers Download. After the download finishes, choose Restart to install it. Celeris does not install updates in the background. Settings shows the version in use. The Android companion updates through Google Play like any other app; when it falls behind the desktop it says so at the top of the screen, and it will keep saying so, because a phone on an old build cannot talk to a newer computer.

Backing up and moving Celeris state​

Celeris can export the part of its state that is safe to carry to another computer: non-secret settings, verified committed installations, and one closed session. This first version is deliberately not a full-device backup. It leaves out the personal archive, memory, credentials, approvals, other users, screenshots, jobs, feeds, remote state and more, so that what it does move is always safe to move. Preview verifies a backup without writing, and a restore is staged for the next restart rather than swapped in under a running app. It is in Settings → Proactive, under the Celeris state backup panel.

Importing from OpenClaw​

If you are coming from OpenClaw, Celeris can read its data and keep what is safe. Every record is classified: literal secrets and authority are rejected outright, memory is kept as personal and untrusted, and schedules, skills and intents stay disabled until you type the exact confirmation shown for each one. A preview imports nothing; you see the classification first, then choose. It is in Settings → Proactive, under the Import from OpenClaw panel.

Next​