A keyboard-first, local-first launcher for macOS, Windows, and Linux. Open apps, files, folders, clipboard history, and quick commands without leaving the keyboard.

📘 Docs · 🎬 Demo video · 📖 User guide

• Find and open anything — apps, files, folders indexed locally. Type, Enter, done.
• Calc inline — type 2^10, 4!, 200*15%, sqrt(2), 2*pi. No command mode needed.
• Kill a process by port — Cmd+/ then kill :3000. Confirms before killing.
• Search clipboard history — c"meeting finds the snippet you copied an hour ago.
• Translate or look up a word — t"hello for quick translation, tw"word for a definition panel.
• Regex, path, and kind-scoped search — r"^Visual.*, git/project/readme, a"safari, f"note, d"documents.
• Switch running apps from the launcher — an icon strip on the right half of the search bar. Cmd+1..Cmd+9 on macOS / Alt+1..Alt+9 on Linux+Windows jumps to a running app. Toggle on/off in Settings > Appearance > Running Apps.

All local. No account. No telemetry. No plugin marketplace to manage.

• Fast — typical search under 1 ms on a 2000-item index; empty-query browse under 30 µs.
• Small — single native app per platform. No Electron, no background daemons.
• Local-first — candidates indexed in a local SQLite file; the only network calls are explicit (t", tw", Cmd+Enter web search).
• Zero-config by default — presets cover common apps (alias_note, alias_code, alias_term, alias_chat, alias_music, alias_brow). Configure more via ~/.look.config when you want to.
• Keyboard-first — every action has a key; mouse never required.

If you want a launcher that stays out of your way and does exactly what you asked, that's the pitch.

If this is useful, ⭐ star the repo — it's the single biggest signal that helps the project keep shipping.

brew tap kunkka19xx/tap
brew install --cask look

Then bind Cmd+Space to Look (disable Spotlight's shortcut in System Settings > Keyboard > Keyboard Shortcuts > Spotlight). Release builds are signed and notarized — no Gatekeeper bypass needed.

Released artifacts are x86_64 only. ARM builds aren't published; if you need one, please open an issue.

Arch Linux (AUR):

yay -S look-bin
# or
paru -S look-bin

Or without an AUR helper:

git clone https://aur.archlinux.org/look-bin.git
cd look-bin
makepkg -si

Ubuntu/Debian:

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/linux/install-look.sh | bash

Or download the .deb manually from Releases and run sudo dpkg -i Look_*.deb.

Any distro (AppImage):

chmod +x Look_*.AppImage
./Look_*.AppImage

After installing, launch with lookapp from a terminal, or search "Look" in your app launcher. Press Alt+Space to toggle the window at any time. Look autostarts on login by default (on full DEs like GNOME/KDE).

Uninstall:

# Arch
yay -R look-bin

# Ubuntu/Debian
sudo dpkg -r look

# AppImage — just delete the file
rm Look_*.AppImage

NixOS (flake):

# Run directly
nix run 'github:kunkka19xx/look?dir=apps/linows'

# Install to profile
nix profile install 'github:kunkka19xx/look?dir=apps/linows'

Declarative (NixOS):

# flake.nix — add input and cachix config
{
  nixConfig = {
    extra-substituters = [ "https://look.cachix.org" ];
    extra-trusted-public-keys = [ "look.cachix.org-1:8elPCeSVBzlDZXqIRKBK9GyLIK/Hoe1xiWZF0ir7uX4=" ];
  };

  inputs.look.url = "github:kunkka19xx/look?dir=apps/linows";
  # ... your other inputs
}

# configuration.nix — add package
{ pkgs, inputs, ... }:
{
  environment.systemPackages = [
    inputs.look.packages.${pkgs.system}.default
  ];
}

Pre-built binaries are served via Cachix. On first rebuild, nix will ask to trust the cache — say yes. No source compilation needed.

Update to latest release:

nix flake update look --flake /path/to/your/flake
sudo nixos-rebuild switch --flake /path/to/your/flake#hostname

Note: On GNOME desktops, log out and log back in after the first install so the GNOME Shell extension (used for window focusing and hotkey on Wayland) can load.

Window manager users (i3, sway, Hyprland, etc.): Autostart via .desktop files only works on full DEs (GNOME, KDE). On standalone WMs, add Look to your config manually. The Alt+Space hotkey and window rules (float, no border) are registered automatically at runtime — you only need the autostart line:

# i3: ~/.config/i3/config
exec --no-startup-id lookapp
# (Alt+Space works via X11 global shortcut plugin)

# sway: ~/.config/sway/config
exec lookapp
# (Alt+Space, float, and border rules are injected automatically via swaymsg)

# Hyprland: ~/.config/hypr/hyprland.conf
exec-once = lookapp
# (Alt+Space, float, and border rules are injected automatically via hyprctl)

Hyprland 0.55+ only. Focus-existing-window uses the wlr-foreign-toplevel-management protocol. Older Hyprland versions relied on the legacy hyprctl dispatch focuswindow syntax which was deprecated in 0.55; selecting an already-running app on <0.55 may launch a second instance instead of focusing. Upgrade to 0.55+ for correct behavior.

To build from source, see apps/linows/BUILDING.md.

Released artifacts are x86_64 only. Windows on ARM (Surface Pro X / Snapdragon X) can run the x64 build under emulation; native ARM builds aren't published — open an issue if you need one.

One PowerShell line, no admin required:

iex "& { $(irm https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/windows/install-look.ps1) }"

The script resolves the latest release, downloads the NSIS installer, verifies its SHA256 against the published checksums, and runs it silently into %LOCALAPPDATA%\Programs\Look. SmartScreen will warn on the first download while reputation builds — click "More info → Run anyway" if Windows blocks the script itself.

Uninstall:

iex "& { $(irm https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/windows/install-look.ps1) } -Uninstall"

The launcher's global hotkey is Alt+Space (not user-configurable yet — if it conflicts with another app you use, remap that one). For a manual install: download Look_<version>_x64-setup.exe from Releases, verify the SHA256 against the published Look-<version>-windows-checksums.txt, then run. Uninstall via Settings → Apps or %LOCALAPPDATA%\Programs\Look\uninstall.exe. To wipe user data: Remove-Item -Recurse "$env:LOCALAPPDATA\look".

# update
brew upgrade --cask kunkka19xx/tap/look

# uninstall
brew uninstall --cask look

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash -s -- --version <version> --repo kunkka19xx/look

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash -s -- --url "https://github.com/kunkka19xx/look/releases/download/v<version>/Look-<version>-macOS.zip"

open "/Applications/Look.app"

(Throughout the rest of the docs, Cmd+X on macOS maps to Ctrl+X on Windows and Linux; the launcher-toggle hotkey uses Alt+Space on Windows/Linux instead of Cmd+Space because Win+Space / Super+Space are typically reserved by the OS or desktop environment.)

Full reference: docs/user-guide.md.

Built-in: Catppuccin, Tokyo Night, Rose Pine, Gruvbox, Dracula, Kanagawa, plus Custom. Switch in Settings > Appearance.

• 📘 Docs site — hosted, searchable user guide and reference
• User guide (in-repo) — full feature reference, shortcuts, configuration, permissions, troubleshooting
• Architecture — how the Swift app + Rust core fit together
• Features — what's shipped, what's planned
• Contributing — how to contribute
• Development — building locally, repo layout, release process

In scope:

• apps, files, folders, clipboard, command mode, translation, regex/path search
• local-first behavior, zero telemetry
• near-term plugin/extension exploration

Out of scope for v1:

• online-first behavior
• semantic/vector search
• full content indexing (names and metadata only)

• macOS — shipped and stable (SwiftUI, native). This is the design source of truth.
• Windows + Linux — a new shared Tauri v2 app (apps/linows/) is under active development. It targets both platforms with a single codebase (Rust backend, vanilla HTML/CSS/JS frontend). Current status:
  • Core search, preview, multi-pick, clipboard history, translation — done
  • Command mode (calc, pomo, kill, shell, sys) — done
  • Settings screen (appearance, themes, blur, font autocomplete) — done
  • Platform-aware blur (Mica/Acrylic on Windows, CSS backdrop-filter on Linux)
  • Dynamic window scaling based on monitor resolution
  • 6 built-in themes + Custom
• Windows (WinUI3) — the current apps/windows/ WinUI3/C# app isarchived.

GPLv3 — see LICENSE.

Thanks to everyone who has contributed — see the contributor graph.