Lumio didn’t offer to update by itself? Older versions can’t do that. Get 1.4.2 with one command (your settings and notes stay):
curl -fsSL https://lumiomac.com/install.sh | sh

For Claude Code, Codex, Cursor, Copilot and other AI agents

Your agents,
in the notch.

Lumio turns the MacBook notch into a control room for Claude Code, Codex, Cursor, GitHub Copilot, Qwen Code, Cline and more. Who’s working, who needs your “yes”, who’s done. One glance, no window switching.

Free · macOS 14 or later · Apple silicon and Intel · Help with install

You run three agents at once. One is done. One is waiting for your “yes”. One crashed ten minutes ago. And you find out only when you switch windows.

Agents

All your agents.
One notch.

Lumio works with eleven AI agents. Each one glows in its own colour in the notch and gets its own little person in the office. New in 1.4: Qwen Code and Cline.

The notch

It calls when it needs you.

When an agent asks for permission or a question, the notch glows in its color, warm for Claude and icy for Codex, and a dot appears in the menu bar. Approve the command or pick an answer right in the notch, no window switching.

Every session. One clear view.

See what each agent is doing and what it needs. A memory bar shows when it’s time to start a fresh session.

Reply without opening a window.

Type in the notch and send. Codex gets it right away. For Claude Code, turn on auto-send and Lumio types it into the right chat for you.

The office

Every agent gets a desk.

Double‑tap the right ⌘ and a pixel office grows out of the notch. Working agents type at their iMacs, and each screen shows what they’re doing: code, terminal or browser. The one who needs you stands up, and the ones who are done go for coffee.

Lit by the real sun.

Sunrise, sunset and night follow the real sun. At night the lamps glow and the screens light up faces.

A thought? Right ⌥.

Tap, type, Enter, and it’s saved. To Lumio, your Obsidian daily note, any folder or Apple Notes. Prefer another key? Pick your own in Settings.

Recap

Your day and week,
in one tab.

What every agent got done today and this week, hour by hour and by project.

Every task has a card.

What you asked, what the agent answered, the files it changed and “Continue in the agent”.

The week in one report.

Your best day, this week against the last, and a weekly report copied with one click.

Music

Your music, glowing around the notch.

Now playing from any player or browser tab, with the colours of the cover breathing around the notch. Make the glow softer or brighter in Settings.

A dev log that writes itself.

What got done, fixed and what’s next, in Obsidian.

A notch on every display.

External monitors get a virtual one. There’s a light theme too: Settings → Appearance.

Your limits in sight.

Claude and Codex limits, right in the office.

Every pixel, drawn in code.

Even the lo‑fi soundtrack. No stock assets.

Your code stays on your Mac.

No accounts, no tracking. No Screen Recording permission; Accessibility only if you turn on sending Claude replies from the notch. Lumio reads your agents’ local files. On its own it sends only the update check, which you can turn off, and it gets Claude’s fresh limit through your own Claude Code. The Support window sends your message only when you click Send; while your request is open (up to 14 days), Lumio checks every 30 minutes whether we replied, sending only the request number and a random key. Live office chats are off by default; when on, short notes about your sessions go to your own agent, with its cheapest model. The daily update check sends a random number for your Mac, the Lumio build and the names of the agents you used this week (like “claude,codex”), and nothing about your files or projects.

Get Lumio.

Free. Ten seconds to install.

  1. 1

    Open Terminal: press ⌘Space, type “Terminal” and press Enter.

  2. 2

    Copy the command and paste it into Terminal: ⌘V.

    curl -fsSL https://lumiomac.com/install.sh | sh
  3. 3

    Press Enter. In about 10 seconds Lumio is in your notch.

The command only downloads Lumio from our site and puts it in Applications. No warnings from macOS.

Why is this safe?
  • It downloads only Lumio from lumiomac.com and puts it in Applications. It doesn’t touch any other files.
  • It doesn’t ask for your Mac password and installs nothing but Lumio.
  • Lumio works on your Mac: your code and your chats with agents stay there. On its own it sends only the update check, which you can turn off, and, after you write to support, a check every 30 minutes whether we replied.

Already have Lumio? The same command updates it to the latest version.

Another way: download the archive
Download Lumio.zip

macOS stops it on first launch. Open it, then go to System Settings → Privacy & Security and click Open Anyway.

Something not working? Write to us, we’ll help you get Lumio running.

Needs macOS 14 Sonoma or later and Claude Code, Codex, Cursor, GitHub Copilot, Antigravity, Gemini CLI, Qwen Code, Cline, OpenCode, Kilo or Pi.
No notch? Lumio draws a virtual one. The dev log needs Obsidian.

What the command runs

This is the whole script behind lumiomac.com/install.sh, line for line.

install.shRaw
#!/bin/sh
# curl -fsSL https://lumiomac.com/install.sh | sh
# Проверяем загрузку до остановки Lumio. Прежняя копия хранится до успешной замены и запуска.
set -eu
tmp=$(mktemp -d)
# Отметку «запустилась» Lumio принимает только в своей временной папке. Открытая через open, она видит системную
# (DARWIN_USER_TEMP_DIR), а не TMPDIR оболочки: со своим TMPDIR был ложный откат «did not start».
user_tmp=$(getconf DARWIN_USER_TEMP_DIR 2>/dev/null || true)
health=$(mktemp -d "${user_tmp:-${TMPDIR:-/tmp/}}lumio-update-health-XXXXXX")
apps=/Applications
# Обычная учётная запись (не администратор) в общие «Программы» писать не может — ставим в свои (~/Applications),
# как и AppMover в самом приложении. Своя копия там уже есть — обновляем её, а не ставим вторую.
if [ ! -e "$apps/Lumio.app" ] && { [ -e "$HOME/Applications/Lumio.app" ] || [ ! -w "$apps" ]; }; then
  apps="$HOME/Applications"
  mkdir -p "$apps"
elif [ ! -w "$apps" ]; then
  echo "Lumio in $apps was installed by an administrator, and only an administrator can replace it." >&2
  echo "Ask them to run this command, or open Lumio: it offers to move itself to your own Applications folder." >&2
  rm -rf "$tmp" "$health"
  exit 1
fi
destination="$apps/Lumio.app"
staged="$apps/.lumio-new-$$.app"
backup="$apps/.lumio-previous-$$.app"
moved=0
installed=0
success=0
stopped=0
cleanup() {
  if [ "$success" -eq 0 ]; then
    if [ "$installed" -eq 1 ]; then
      pkill -x Lumio 2>/dev/null || true
      for attempt in 1 2 3 4 5; do pgrep -x Lumio >/dev/null || break; sleep 0.1; done
      rm -rf "$destination"
    fi
    if [ "$moved" -eq 1 ] && [ ! -e "$destination" ]; then mv "$backup" "$destination"; fi
    if [ "$stopped" -eq 1 ] && [ -e "$destination" ]; then open -g "$destination" 2>/dev/null || true; fi
  fi
  rm -rf "$tmp" "$staged" "$health"
}
trap cleanup EXIT
trap 'exit 1' HUP INT TERM
echo "Downloading Lumio…"
curl --proto '=https' --tlsv1.2 -fsSL --max-filesize 65536 https://lumiomac.com/latest.json -o "$tmp/latest.json"
version=$(plutil -extract version raw -o - "$tmp/latest.json")
build=$(plutil -extract build raw -o - "$tmp/latest.json")
bytes=$(plutil -extract bytes raw -o - "$tmp/latest.json")
checksum=$(plutil -extract sha256 raw -o - "$tmp/latest.json")
case "$version" in ''|*[!0-9.]*|.*|*..*|*.) echo "Invalid release version" >&2; exit 1;; esac
case "$build:$bytes" in *[!0-9:]*) echo "Invalid release size or build" >&2; exit 1;; esac
[ "$build" -gt 0 ] && [ "$bytes" -gt 0 ] && [ "$bytes" -le 67108864 ]
[ "${#checksum}" -eq 64 ]
case "$checksum" in *[!0-9a-f]*) echo "Invalid release checksum" >&2; exit 1;; esac
curl --proto '=https' --tlsv1.2 -fsSL --max-filesize "$bytes" https://lumiomac.com/Lumio.zip -o "$tmp/Lumio.zip"
[ "$(stat -f %z "$tmp/Lumio.zip")" -eq "$bytes" ]
[ "$(shasum -a 256 "$tmp/Lumio.zip" | awk '{print $1}')" = "$checksum" ]
# Даже до распаковки исключаем пути вне приложения и внешние символические ссылки.
zipinfo -1 "$tmp/Lumio.zip" > "$tmp/paths"
awk 'BEGIN {bad=0} /^\// || /\\/ || /(^|\/)\.\.(\/|$)/ {bad=1} !/^Lumio\.app\// && !/^__MACOSX\// {bad=1} END {exit bad || NR == 0 || NR > 20000}' "$tmp/paths"
zipinfo -l "$tmp/Lumio.zip" > "$tmp/entries"
awk '/^[-dl]/ {total += $4} END {exit total > 268435456}' "$tmp/entries"
sed -n 's/^l[^ ]* *[^ ]* *[^ ]* *[^ ]* *[^ ]* *[^ ]* *[^ ]* *[^ ]* *[^ ]* *//p' "$tmp/entries" > "$tmp/links"
while IFS= read -r path; do
  link=$(unzip -p "$tmp/Lumio.zip" "$path")
  case "$link" in ''|/*|*\\*) echo "Invalid archive link" >&2; exit 1;; esac
  printf '%s\n' "$link" | awk '/(^|\/)\.\.(\/|$)/ {exit 1}'
done < "$tmp/links"
ditto -x -k "$tmp/Lumio.zip" "$tmp"
app="$tmp/Lumio.app"
info="$app/Contents/Info.plist"
[ "$(plutil -extract CFBundleIdentifier raw -o - "$info")" = com.lumiomac.lumio ]
[ "$(plutil -extract CFBundleShortVersionString raw -o - "$info")" = "$version" ]
[ "$(plutil -extract CFBundleVersion raw -o - "$info")" = "$build" ]
codesign --verify --deep --strict "$app"
# Не lipo: без инструментов разработчика (обычный Mac) он не работает.
file -b "$app/Contents/MacOS/Lumio" | grep -q "$(uname -m)"
if [ -e "$destination" ]; then
  [ ! -L "$destination" ]
  [ "$(plutil -extract CFBundleIdentifier raw -o - "$destination/Contents/Info.plist")" = com.lumiomac.lumio ]
  for personal_key in LumioPhoneServer LumioSunLatitude LumioSunLongitude; do
    personal_current=$(plutil -extract "$personal_key" raw -o - "$destination/Contents/Info.plist" 2>/dev/null) || personal_current=
    if [ -n "$personal_current" ]; then
      personal_candidate=$(plutil -extract "$personal_key" raw -o - "$info" 2>/dev/null) || personal_candidate=
      if [ "$personal_current" != "$personal_candidate" ]; then
        echo "Personal build detected. Update it from your project to keep your phone office connected." >&2
        exit 1
      fi
    fi
  done
fi
# Сначала готовим новую копию рядом со старой: неудачная запись не ломает установленное приложение.
ditto "$app" "$staged"
codesign --verify --deep --strict "$staged"
pkill -x Lumio 2>/dev/null || true
stopped=1
for attempt in 1 2 3 4 5; do pgrep -x Lumio >/dev/null || break; sleep 1; done
if pgrep -x Lumio >/dev/null; then echo "Quit Lumio, then try again." >&2; exit 1; fi
if [ -e "$destination" ]; then mv "$destination" "$backup"; moved=1; fi
mv "$staged" "$destination"
installed=1
xattr -dr com.apple.quarantine "$destination" 2>/dev/null || true
open -g "$destination" --args --lumio-update-health "$health/ready"
ready=0
for attempt in $(seq 1 30); do
  if [ -f "$health/ready" ] &&
     [ "$(plutil -extract version raw -o - "$health/ready" 2>/dev/null)" = "$version" ] &&
     [ "$(plutil -extract build raw -o - "$health/ready" 2>/dev/null)" = "$build" ]; then ready=1; break; fi
  sleep 1
done
[ "$ready" -eq 1 ] || { echo "Lumio did not start; restoring the previous version." >&2; exit 1; }
success=1
if [ "$moved" -eq 1 ]; then rm -rf "$backup"; fi
echo "Lumio is installed in $apps and running."

Almost there.

Lumio is downloading. The first time you open it, macOS asks you to confirm, only once.

Fastest: paste one command into Terminal and press Enter. No warnings, no Settings.

curl -fsSL https://lumiomac.com/install.sh | sh

Why? Lumio is a free app from an independent developer and isn’t notarized by Apple yet.

Or open the downloaded app in four steps:

  1. Lumio
    Applications
    1

    Move it to Applications

    In Downloads you’ll find Lumio (if there’s only Lumio.zip, open it first). Drag Lumio into Applications.

  2. “Lumio” Not Opened Apple could not verify “Lumio” is free of malware that may harm your Mac or compromise your privacy. Move to Trash Done
    2

    Open it and click “Done”

    macOS doesn’t know Lumio yet and stops it. Click Done, not “Move to Trash”.

  3. System Settings› Privacy & Security
    Security
    “Lumio” was blocked to protect your Mac. Open Anyway
    3

    Allow it in Settings

    Open System Settings → Privacy & Security, scroll down and click Open Anyway.

  4. Open “Lumio”? Apple cannot verify that this file is free of malware that may harm your Mac or compromise your privacy. Move to Trash Open Anyway Done
    4

    Click “Open Anyway” once more

    macOS asks one last time. Click Open Anyway and confirm with your password or Touch ID. Done. Lumio is in your notch, and macOS won’t ask again.

Didn’t open, or something’s unclear? Write to support, we’ll help