← Back to resources

Getting started

Six steps, from install to habit. CoolDesk is free and needs no account.

Install the desktop app

Download it for your system from the downloads section, or use a package manager:

Windows

winget install CoolDesk.CoolDesk

macOS (Homebrew)

brew tap abhayraghuwanshi/cooldesk \
  https://github.com/abhayraghuwanshi/cooldesk-extension
brew trust --cask abhayraghuwanshi/cooldesk/cooldesk
brew install --cask cooldesk

Installed from the DMG instead? macOS may say the app is damaged. Here’s the one-line fix.

Linux

Download the AppImage, make it executable, and run it. It works on any distro.

Add the browser extension

Get it from the Chrome Web Store. It works in Chrome, Edge, Brave and other Chromium browsers.

Your new tab becomes a dashboard, and the desktop app can now see your open tabs, history and bookmarks. There’s nothing to sign in to.

Only want the new tab? The extension works on its own. Spotlight, spaces and layouts need the desktop app.

Turn on Desktop Sync

Desktop Sync connects the extension to the desktop app, so Spotlight can find your tabs and your spaces stay the same in both. It’s on by default; here’s how to check:

  1. Open a new tab and click the gear icon (Settings).
  2. In General, scroll to Sync.
  3. Switch on Desktop Sync.
  4. Check Status shows a green dot and “App connected”. Press Sync Now to sync straight away.
Settings

Sync

Desktop Sync
Connect to the CoolDesk desktop app on port 4545
Status
App connected
Sync Now
See each status:

Status says “App not found — is it running?” Start the desktop app, then press Retry. Sync runs on your own computer (localhost, port 4545); nothing goes to a server.

Make your first space

A space holds everything for one thing you work on: tabs, links, apps, folders, files and notes. Name it after the work, like “Acme redesign” or “Thesis”.

  • Create one from the Spaces view (Ctrl+3).
  • Add what’s already open: pick tabs from your open tabs and put them in the space.
  • Drag folders and files onto the space to add them.
  • Starting from chaos? Let the AI group your recent browsing into spaces, then tidy up.

Then close tabs freely. They’re saved in the space, one click away.

Find anything with Alt+K

Press Alt+K from anywhere and type a word. Spotlight searches your open tabs, spaces, history, bookmarks, apps, files and notes together, and jumps to a tab that’s already open instead of opening a copy.

Alt+K taken by another app? Change it in Settings.

Pick a layout

Press Ctrl+Shift+D (⌘+Shift+D on Mac) to cycle through three layouts:

  • Full window: the complete view of your spaces.
  • Side dock: a slim handle on the screen edge that slides in your spaces, tabs and notes.
  • Bottom bar: a Mac-style dock with what’s open now, or the current space’s links, apps and files.

Shortcuts

Alt+K
Open Spotlight from anywhere (change it in Settings)
Ctrl+Shift+D / ⌘+Shift+D
Switch layout: full window, side dock, bottom bar
Ctrl+1 Ctrl+2 Ctrl+3
Collections, Tabs and Spaces in the full window

Optional: AI

AI is optional, and CoolDesk works fully without it. When you want it:

  • Local model: Settings → Local AI downloads Qwen2.5 7B (4.7 GB, about 6–8 GB of RAM). It runs on your device and works offline.
  • Your own API key: OpenAI, Anthropic or Gemini.
  • Coding agents: Claude Code or OpenCode, from the terminal.

If something’s off

macOS says CoolDesk is damaged and can’t be opened

The app isn’t notarized by Apple yet, so macOS flags any download from outside the App Store. Run this once in Terminal, then open CoolDesk again:

xattr -dr com.apple.quarantine /Applications/CoolDesk.app

Installing with Homebrew does this for you.

Windows SmartScreen warns about the installer

SmartScreen can warn about newer apps it hasn’t seen many installs of. Click More info, then Run anyway.

Spotlight doesn’t show my browser tabs

Make sure the desktop app is running, then check Desktop Sync in the extension’s Settings: it should be on and the status should say “App connected”. If it says the app wasn’t found, press Retry, or restart the browser.

Alt+K does nothing

Another app may already use that shortcut. Open CoolDesk’s Settings and pick a different Spotlight shortcut. If one can’t be registered, CoolDesk falls back to Alt+K.

How do I update?

The desktop app updates itself; the extension updates through the Chrome Web Store. See what changed in the release notes.

Still stuck? Ask in GitHub Discussions or on r/cooldesk.

Your data stays on your device

Only an anonymous usage ping (you can turn it off), cloud AI with your own key, and Team sync send anything out.