A Raycast-style launcher for Windows and macOS, written in Go with the
MyGo native UI toolkit.
简体中文
Ask AI which app uses the most memory: it reads the process list through the launcher's own tools
|
Ask AI which apps can be updated (WinGet and Scoop) |
Curre 8000 ncy conversion |
|
Translate as you type with tr
|
Context aware: actions for the file selected in File Explorer |
- Press Alt+Space (⌥Space on a Mac) anywhere to search apps, commands, files and math. On macOS, ⌘ takes the place of Ctrl in every shortcut.
- Everything is a plugin. The built-in features use the same plugin SDK that third-party plugins use.
- Context aware: open it from File Explorer, Finder or the desktop and the top of the list offers actions for that folder and the selected files: open a terminal or VS Code there, create a folder or text file, copy paths, compress to ZIP, copy a SHA-256, search the folder with Everything or Spotlight. Works with Windows 11 tabs, and with any window whose title (or, on a Mac, whose document) shows a path. Nothing is stored, and it can be turned off in Settings (docs/context-awareness.md).
- Selected text: select some text in any app, press Alt+Space, and the top of the list offers actions for it: translate, ask AI (explain, summarize, rewrite, suggest replies, or type an instruction), search the web, open it if it is a link, calculate it if it is an expression, see the full text and its word count. It is read with UI Automation on Windows and the Accessibility API on macOS, without touching the clipboard; copying with Ctrl+C / ⌘C (the clipboard put back at once) is an opt-in fallback for apps that do not support it. The text is never stored and is sent to AI only when you pick an AI action (docs/selected-text.md).
- Files in the main search: drop files onto the launcher, paste copied
files or an image with
Ctrl+V, or choose them withCtrl+Oor Choose Files…. They show as chips, and a Files section at the top offers what you can do with them: Ask AI about…, Open, Open With… (Windows), Show in File Explorer or Show in Finder, copy the paths or names, Compress to ZIP, copy the SHA-256 checksum, Copy Image. Type to filter the actions. A chip's × removes one file;Escremoves them all. The files are never recorded or shown to AI unless you pick Ask AI (docs/root-files.md). - Action Ring: hold the middle mouse button to open a ring of actions
around the pointer: open golauncher, ask AI, take a screenshot, lock the
screen, plus actions for the selected text or the folder under the pointer.
Drag toward one and let go, or click it or press
1–8. A short click of the middle button still goes to the app; remote desktops, virtual machines and Blender are left alone (Settings › Action Ring, docs/action-ring.md). - Built-in plugins
- Applications: Start menu apps, including Store apps, on Windows; the
apps in Applications and the system folders, with their localized names,
on macOS. Pinyin matching (
wxfinds 微信) (docs/app-names.md). - Calculator: exact decimal arithmetic, functions, and base conversion
(
255 in hex), plus unit conversion:10 km in mi,30 ℃,5 GB / 100 Mbps,3 斤 to kg,8 L/100km in mpg,16 px in rem, currencies (100 usd in cny, free rates without an API key, cached for offline use), timestamps (1700000000 to date,now in unix), colors (#ff8800 to hsl) and clothing/shoe sizes (US 9 shoe in EU). Units have English, Chinese and pinyin names (10 公里 换成 英里) (docs/unit-conversion.md). - Clipboard History (
Alt+Shift+V,⌥⇧V): text, images and files, with full-text search. Copies from password managers are skipped. - Files: the context actions above (
builtin.files). - File Search: powered by Everything on Windows, when it is installed, and by Spotlight on macOS (docs/everything.md).
- Scoop (Windows): search, install, update and remove Scoop packages, when Scoop is installed (below, docs/scoop.md).
- WinGet (Windows): search, install, upgrade and remove packages with
the Windows Package Manager (
winget), when it is installed (below, docs/winget.md). - Homebrew (macOS): search formulae and casks, install, upgrade and uninstall them, and list installed and outdated packages, when Homebrew is installed (docs/homebrew.md).
- System: Lock, Sleep, Restart, Shut Down, Sign Out, Empty Recycle Bin
or Trash, Toggle Dark Mode, volume and Turn Off Display (plus Hibernate
and Show Desktop on Windows), with about 150 Windows Settings pages and
the classic tools (Device Manager, Services, Registry Editor, …) on
Windows, or the System Settings panes and utilities on macOS; searchable
in English, Chinese and pinyin (
蓝牙,wifi,关机,gj). Restart, Shut Down, Sign Out and emptying the bin ask first (docs/system-commands.md). - Terminal: on Windows, your Windows Terminal profiles (including fragments such as Git Bash) and WSL distributions with their running state; open one in a new window or tab, as administrator or in the current folder, set the default distribution, stop it, shut down or update WSL. On macOS, Terminal, iTerm2, Ghostty, WezTerm, Alacritty, kitty and Warp: a new window or tab, in the current folder, or running a command, with a default terminal of your choice (docs/terminal-wsl.md).
- World Clock: type
timefor your local time and major cities, ortime tokyo,time bj,time 北京,time utc+8,time pstto find one of about 32,000 cities (every city of 15,000 people or more, from GeoNames). The clocks tick; favorite cities stay on top (docs/world-clock.md). - Timers & Reminders:
timer 25m,timer 1h30m tea,计时 半小时start a countdown;remind 15:30 meeting,remind tomorrow 9am,提醒 明天 9点 交周报,remind in 20mset a reminder.timerlists the running ones with the time left (pause, resume, +5 min, restart, cancel and undo); a notification comes when they end. Timers survive restarts, and reminders missed while golauncher was not running are announced when it starts (docs/timers.md). - Quicklinks & Web Search:
g golang generics,bd 天气,gh,yt,wiki,zhihu,bili… (20 built-in engines) search the web (add your own engines, change keywords); a typed URL (github.com/foo,localhost:3000) opens directly; when nothing matches, Search Google for “…” is offered (Bing in the Chinese UI). Quicklinks are your named links to websites, files, folders and programs with{query},{clipboard}and{date}placeholders, created with a form and imported or exported as JSON. Search suggestions are off by default. Google Translate's web search isgt(the translator tooktr) (docs/quicklinks.md). - Translator:
tr hello,fy …or翻译 …translates as you type, with each engine on its own row. Without a key it uses Google Translate's web endpoint (unofficial), and MyMemory when that fails. With your own keys, DeepL, Azure AI Translator, Youdao and Baidu are asked first. A single word also gets a dictionary entry; translations can be read aloud or handed to the AI chat (Translate with AI). Add your own HTTP engines, or translate offline with Ollama (below, docs/translator.md). - Network Tools:
ipshows your adapters' addresses, gateway, DNS, Wi-Fi network and signal, and your public IP;ping <host>pings live with statistics;dns <domain> [@server]looks up records;port 8080shows (and can end) the process listening on a port, andport host:443checks whether a port can be reached;wificopies the password of a saved network;tracert <host>, Flush DNS Cache and (on Windows) Renew IP Address run in the background (docs/network-tools.md). - Processes:
ps(with a space),killor进程lists running apps and processes grouped by app, with live CPU and memory bars; search by name, window title, pinyin or PID. Enter switches to the window; End Task asks an app to close, Force End and End Process Tree ask first; elevated processes are ended through a one-off UAC prompt (on macOS, the administrator password prompt). Critical system processes and golauncher itself cannot be ended. Quit acts on the app in front, and Force Quit is offered when it hangs (docs/process-manager.md). - AI Chat (off until you turn it on): press
Tabafter typing a question, or pick Ask AI when nothing matches, to chat with Claude through your installed Claude Code CLI and your Claude subscription (no API key). Answers stream in; ask follow-ups, stop withEsc, copy or paste the answer, continue in the Claude or ChatGPT app, and reopen chats from AI Chat History (kept 30 days by default). Claude can use the launcher's plugins ("8080 port — who has it?", "install 7-Zip with winget"): it searches and runs them through golauncher's own tools, every step shows in the chat, and anything that changes something asks you first in the launcher (Allow, Allow for this session, Deny; destructive actions always ask). Web search is an option. Instead of Claude Code you can choose Codex (your ChatGPT account; golauncher runs the native Codex binary, e.g. the one the Codex app, Homebrew or npm installs) or Gemini CLI (your Google account; Gemini CLI itself needs Node.js) in Settings › Plugins › AI › Backend. Each runs isolated from your own setup of that CLI (no other MCP servers, hooks, extensions or memory files, no file or shell tools), each chat stays on the backend it started with, and when Gemini asks for permission to use a tool you answer in the same dialog. Settings › Plugins › AI › Backends shows, for each backend, whether it is available, which installed program it runs (path, version, where it was found) and the other installations it found; when one is installed more than once you can pick which one, or enter a path. Copy an answer, paste it elsewhere and reopen the launcher: you are back in the chat, with your unsent draft (within 10 minutes by default; Settings › General › Return to the main screen; docs/keep-view.md). Attach images and text files to a message: drop files onto a chat, paste an image or copied files withCtrl+Vin a chat (an image copied from a browser or a chat app works too), or choose them with Add Attachment… (Ctrl+O). From the main search, Ask AI about… opens a new chat with the files you gave it. Images (PNG, JPEG, GIF, WebP; BMP and TIFF are converted) are scaled down to at most 2000 px, text files (up to 200 KB) are sent inline; up to 10 per message. PDF, Office documents, video and audio show as unsupported and keep the message from being sent until you remove them (docs/ai.md). - Custom AI actions: Settings › Plugins › AI › AI Actions edits, reorders, turns off or adds the actions offered for the selected text and for files, with prompt placeholders (
{selection},{lang},{input},{app},{date}) and an optional result view that only shows the answer (Enter pastes or replaces the selection, Tab follows up in a chat) (docs/ai-actions.md). - Use golauncher from Claude Desktop or Claude Code (off until you
turn on Settings › Plugins › AI › Allow AI apps to use golauncher):
golauncher mcpis an MCP server for your plugins. The settings page connects Claude Desktop for you (only itsgolauncherentry, after a backup) and shows theclaude mcp addcommand for Claude Code. You choose which plugins AI may use (clipboard history and third-party plugins are off by default); AI Activity lists every tool call of the last 30 days (docs/ai.md).
- Applications: Start menu apps, including Store apps, on Windows; the
apps in Applications and the system folders, with their localized names,
on macOS. Pinyin matching (
- Settings window (
Ctrl+,,⌘,): set hotkeys, aliases, plugin preferences, the appearance and the language, and, on macOS, see which permissions golauncher has (Settings › Permissions). - Themes (Settings › Appearance, docs/themes.md): 18
built-in themes (golauncher Light/Dark, Crimson, GitHub, Nord,
Dracula, Catppuccin, Tokyo Night, Solarized, Gruvbox, One Dark, Paper and
two high-contrast themes) in a gallery of live thumbnails; separate light
and dark themes when following the system; a background opacity slider
that lets the Acrylic or Mica material show through on Windows while text
stays solid (solid when transparency effects or a contrast theme are on);
the theme's, the system's or your own accent color; corner radius,
density and text size. Your own themes are JSON files in
%APPDATA%\golauncher\themes(~/Library/Application Support/golauncher/themeson macOS) that canextendanother theme and reload as you save them;glctl theme validatechecks them, contrast included. - English and Simplified Chinese UI: golauncher follows the system's display language (Simplified Chinese for zh-CN, zh-Hans and zh-SG, English otherwise). To switch, open Settings › General › Language and pick System default, English or 简体中文; the change applies at once. English command names and keywords keep working in the Chinese UI.
glctl: a headless CLI that drives the same engine, so you or an AI agent can test every flow without the GUI.
Status: v0.11 is an early public release for Windows and macOS; see the changelog for what each release added. See the design document for the architecture and the roadmap.
Download golauncher_<version>_windows_<arch>.zip from
Releases, unzip it and run
golauncher.exe. On first run it offers to install itself into
%LOCALAPPDATA%\Programs\golauncher (no administrator rights needed) with a
Start menu entry and an entry in Settings › Apps for uninstalling. Running a
newer or older download later offers to upgrade or downgrade; the same version
just starts the installed copy. Choose Run without installing (or pass
--portable) to run it from where it is. golauncher lives in the system tray.
winget (once the package is accepted into the winget community
repository): winget install eziq1.golauncher, and later
winget upgrade eziq1.golauncher. The package is under review: the pull
request microsoft/winget-pkgs#454732
passed the automated checks and waits for a human reviewer. Quit golauncher
before upgrading. Since 0.9.0, a copy installed with winget does not offer
to install itself and leaves updates to winget (Settings › About says so).
See
docs/winget-packaging.md.
Automatic updates: the installed copy checks GitHub Releases for a new stable version (30 seconds after starting, then daily or weekly), downloads the archive for your architecture, verifies it against the release's SHA-256 checksums and installs it when golauncher is idle (hidden, no background task or AI answer running, not used for a few minutes); it then restarts and says what's new. If the new version does not start, the previous one is restored and the version is skipped. Settings › About shows the status and lets you check now, skip a version, or choose Only notify me or Off; the tray menu and the Check for Updates command check too. Portable copies and development builds never update themselves. See docs/auto-update.md.
Requirements:
- Windows 10 or 11. The Acrylic panel background requires Windows 11.
- The WebView2 runtime is not needed.
golauncher.exe --show # show the launcher
golauncher.exe --settings # open Settings
golauncher.exe --quit # quit the running instance
golauncher.exe --portable # run without installing
golauncher.exe --uninstall # remove the installation| What | Where |
|---|---|
| Configuration | %APPDATA%\golauncher\config.json |
| Databases, clipboard history | %LOCALAPPDATA%\golauncher\data\ (never roams) |
| Logs | %LOCALAPPDATA%\golauncher\logs\golauncher.log (updates: update.log) |
| Updates (downloads, previous version) | %LOCALAPPDATA%\golauncher\update\ |
Download golauncher_<version>_darwin_arm64.zip (Apple silicon) or
golauncher_<version>_darwin_amd64.zip (Intel) from
Releases and unzip it. The app
is not notarized yet, so the first time Control-click golauncher.app ›
Open (on macOS 15: open it once, then System Settings › Privacy & Security
› Open Anyway), or run xattr -dr com.apple.quarantine golauncher.app. On
first run it offers to install itself into /Applications (or
~/Applications). It lives in the menu bar, with no Dock icon; press
⌥Space to search.
Settings › Permissions shows what macOS needs you to allow: Accessibility (pasting, the selected text) and Automation › Finder (the current Finder folder). Because the app is not signed with a Developer ID, macOS forgets the Accessibility permission after each update: remove golauncher from the list and add it again. Automatic updates work as on Windows. Requires macOS 13 or later. See docs/macos-port.md.
Homebrew: brew install --cask eziq1/tap/golauncher, and later
brew upgrade --cask golauncher (then quit and reopen golauncher). The cask
comes from the tap eziq1/homebrew-tap.
It installs golauncher.app into /Applications and links glctl into
Homebrew's bin. The app is ad hoc signed, not notarized, so macOS blocks
its first start: open it once, then choose System Settings › Privacy &
Security › Open Anyway. You may have to do this again after an upgrade.
Since 0.9.0, a copy installed with Homebrew does not offer to install
itself and leaves updates to Homebrew (Settings › About says so). If
golauncher already installed
itself into /Applications, quit it and remove that copy first (your
settings are kept), or use brew install --cask --adopt for the same
version. brew uninstall --zap --cask golauncher also removes your settings
and data. See docs/homebrew-packaging.md.
| What | Where |
|---|---|
| Configuration | ~/Library/Application Support/golauncher/config.json |
| Databases, clipboard history | ~/Library/Application Support/golauncher/data/ |
| Logs | ~/Library/Caches/golauncher/logs/golauncher.log (updates: update.log) |
On a Mac, press ⌥ for Alt and ⌘ for Ctrl (⌥Space, ⌘K, ⌘,); ⌃N and ⌃P also move the selection.
| Key | Action |
|---|---|
Alt+Space |
Show or hide the launcher (configurable) |
↑ ↓, Ctrl+N Ctrl+P |
Move the selection |
Enter / Ctrl+Enter |
Run the primary / secondary action |
Ctrl+K |
Open all actions of the selected item |
Ctrl+O |
Main search: choose files to act on. AI chat: Add Attachment… |
Ctrl+V |
Main search and AI chat: paste copied files or an image as files (text still pastes as text) |
Esc |
Clear the search, go back, or hide. In the main search with files: clear the text first, then the files, then hide |
Ctrl+, |
Open Settings |
| Hold the middle mouse button | Open the Action Ring; then 1–8 choose an action, Esc closes it |
When the selected item has its own Ctrl+O action, that action wins.
Requires Go 1.27 or later. No cgo is needed.
Windows:
git clone https://github.com/eziq1/golauncher
cd golauncher
pwsh scripts/windows/build.ps1 # builds dist/golauncher.exe and dist/glctl.exe
# or by hand:
go build -ldflags "-H windowsgui" -o golauncher.exe ./cmd/golauncher
go build -o glctl.exe ./cmd/glctlmacOS:
git clone https://github.com/eziq1/golauncher
cd golauncher
scripts/macos/build.sh --app # builds dist/golauncher.app (this Mac's architecture)
scripts/macos/build.sh --arch arm64 --app --zip # the release zip for Apple silicon (amd64 for Intel)
scripts/macos/build.sh --debug # unoptimized dist/golauncher and dist/glctl, for DelveAll the scripts are listed in scripts/README.md.
go test ./... # unit, integration, golden and lint tests
go test -race ./internal/... ./plugins/... # needs a C compiler for -race
go test ./internal/cli -update # refresh golden files after an intended output changeTests that touch the real clipboard are skipped unless you opt in with $env:GOLAUNCHER_CLIPBOARD_TESTS=1 (they restore the clipboard afterwards). Tests that read the selected text of real controls (only in windows the test creates) need $env:GOLAUNCHER_SELECTION_TESTS=1.
The end-to-end test drives a running GUI through a local control socket, which is only enabled when golauncher is started with GOLAUNCHER_CONTROL=1:
$env:GOLAUNCHER_CONTROL=1; .\golauncher.exe --portable
$env:GOLAUNCHER_E2E=1; go test ./internal/shell -run RunningInstanceRelease builds (scripts/windows/build.ps1, GitHub releases) leave MyGo's developer
tools out. For the inspector and the Performance panel, build a dev binary
(no version stamp, so the version is dev, the tools are on and the
installer is skipped):
go build -ldflags "-H windowsgui" -o golauncher-dev.exe ./cmd/golauncher
.\golauncher.exe --quit # only one instance runs at a time
.\golauncher-dev.exeThen press F12 or Ctrl+Shift+I in the launcher or Settings (pick an
element with Ctrl+Shift+C). A version-stamped build without the
mygo_noinspector tag shows them with GOLAUNCHER_DEVTOOLS=1;
MYGO_FRAME_STATS=1 logs slow frames without the panel.
glctl query vsc --fixtures testdata/fixtures --format text
glctl query "12*3+4"
glctl run builtin.clipboard/history --text hello --fixtures testdata/fixtures
glctl session new -s s.json --fixtures testdata/fixtures
glctl session type -s s.json "clipboard history"
glctl session key -s s.json Enter
glctl i18n check
glctl theme validate my-theme.json --format text
glctl attach type vsc # drive a GUI started with GOLAUNCHER_CONTROL=1
glctl update check --current 0.4.0 --format text # against a fake GitHub
glctl update check --real # the real GitHub (read only)
glctl update download --dry-run # download and verify, install nothingBy default glctl runs in an isolated, in-memory environment with a fixed
clock. Actions are recorded and printed, not performed. To use your real
configuration and data, pass --real. To actually perform actions, also pass
--exec.
Any script with Raycast Script Commands
metadata becomes a command. Put .ps1, .py, .js, .bat/.cmd or .sh
files in %APPDATA%\golauncher\scripts (more folders can be added in the
settings), or run Create Script Command to start from a template:
# @raycast.schemaVersion 1
# @raycast.title Flush DNS
# @raycast.mode compact
# @raycast.argument1 { "type": "text", "placeholder": "host", "optional": true }
ipconfig /flushdns | Select-Object -Last 1Modes silent, compact and fullOutput are supported (inline runs as
compact). See the plugin guide.
Type tr, fy or 翻译 and a space, then the text. Nothing is sent before
you type a prefix.
| Input | Result |
|---|---|
tr hello world |
Into the interface language (into English if the text is already in it) |
tr ja good morning, tr >ja …, tr 日 … |
Into Japanese: a language code, > and a code, or a Chinese name |
tr en>zh apple |
From English into Chinese |
tr serendipity |
A single word also gets a Dictionary row (phonetics, parts of speech, meanings) |
Enter copies the translation; Ctrl+Enter pastes it into the previous
window. More actions: Copy Original Text (Ctrl+Shift+C), Swap
Languages, Read Translation Aloud and Read Original Aloud (SAPI on
Windows, say on macOS), Translate with AI (opens an AI chat), and open
the text in Google Translate, DeepL or Youdao. The Translate command
opens the same as a view.
Engines, in the translator's settings:
- Without a key: Google Translate's web endpoint (unofficial, may stop working, usually unreachable in mainland China). When every engine fails, MyMemory is asked instead.
- With your own key: DeepL, Azure AI Translator, Youdao and Baidu. They are asked first. Keys are stored in the Windows Credential Manager or the macOS Keychain.
- Custom engines: one HTTP template per line
(
name | GET or POST | URL | JSON path [| body [| headers]], with{text},{from}and{to}). - A local model through Ollama, offline.
Two options are off by default: Translate selected text at once (a row in
the Selected Text section, with Replace Selected Text) and Keep a
translation history (the translations you copy or paste, on this computer
only; see Translation History). Google Translate's web search moved to
gt. See docs/translator.md.
When Scoop is installed ($SCOOP, %USERPROFILE%\scoop,
or the folder set in the plugin settings), these commands appear:
| Command | What it does |
|---|---|
| Search Scoop Packages | Search all bucket manifests by name, command or description as you type. Enter installs; installed apps offer update, hold/unhold, open folder and uninstall (Ctrl+X). |
| Installed Scoop Apps | Installed apps with their version, bucket and hold state; apps with a newer version first. |
| Scoop Updates | What scoop status would report, computed locally, with Update All. |
| Update All Scoop Apps / Update Scoop Buckets | scoop update and scoop update *. |
| Scoop Buckets | Added and known buckets; add, remove, or add a custom one by URL. |
| Clean Up Scoop | Shows how much old versions and the download cache take, then runs scoop cleanup * and scoop cache rm *. |
Searching reads Scoop's files directly (about 6,000 manifests in well under a
millisecond per query), so it does not start PowerShell. Changes run scoop
as background tasks, one at a time: the launcher stays usable, Background Tasks
(Ctrl+J, or the spinner in the footer) shows their live output, and a
notification tells when they finished.
Turn on Search packages from the main search to type scoop <name> or
sc <name> in the main search. Apps installed for all users (-g) are shown
read-only.
When the Windows Package Manager (winget, part of App Installer) is
installed, these commands appear:
| Command | What it does |
|---|---|
| Search WinGet Packages | Search the winget source by name, ID, moniker, command or tag as you type. Enter installs; Ctrl+D shows the details (publisher, description, license, homepage, release notes); installed packages offer upgrade, pin/unpin and uninstall (Ctrl+X). |
| Installed WinGet Packages | Everything winget list reports, including software installed without winget (which can only be uninstalled); packages with a newer version first. |
| WinGet Updates | Packages with a newer version, with Upgrade All (pinned packages are skipped). |
| Upgrade All WinGet Packages | winget upgrade --all, after a confirmation. |
| WinGet Sources / Update WinGet Sources | The configured sources; winget source update. |
Searching reads the local index of the winget source (about 15,000
packages, a couple of milliseconds per query), so typing never starts winget.
The installed packages come from winget list, which takes seconds: it runs
in the background, the last result is cached, and the views refresh when it is
done. Changes run winget as background tasks, one at a time, without prompts
(--disable-interactivity, agreements accepted); installers that need
administrator rights show the UAC prompt, and Install/Upgrade as
Administrator (Ctrl+Shift+A) runs the command in an elevated console for
packages that need winget itself elevated. Type winget <name> or wg <name>
in the main search to list matching packages. See docs/winget.md.
See the plugin guide.
| Path | Contents |
|---|---|
pkg/plugin |
Plugin SDK |
internal/core |
Engine and interaction state machine (UI-independent) |
internal/ui, internal/shell |
GUI: views, windows, tray, hotkeys |
internal/cli |
glctl |
plugins/ |
Built-in plugins |
internal/winapi |
Win32/COM bindings (pure Go) |
docs/ |
Design document and guides |
The World Clock's city data comes from GeoNames
(cities with a population of 15,000 or more, their regions, countries and
Chinese names), licensed under
CC BY 4.0. It is converted by
scripts/data/gencities and embedded in the program.
LaTeX math in Markdown (AI answers) is converted to MathML by treeblood (MIT), then laid out by golauncher (docs/math.md).