# Repository: Wox-launcher/Wox
# Stars: 26678

## README.md

# Wox

[![Build status](https://github.com/Wox-launcher/Wox/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/Wox-launcher/Wox/actions)
[![GitHub release](https://img.shields.io/github/v/release/Wox-launcher/wox?include_prereleases)](https://github.com/Wox-launcher/Wox/releases)
[![Downloads](https://img.shields.io/github/downloads/Wox-launcher/Wox/total.svg)](https://github.com/Wox-launcher/Wox/releases)

Wox is an open-source cross-platform launcher for macOS, Linux, and Windows. It is designed for fast local search, extensibility through plugins, and a lightweight distribution model that can run from a single executable.

It is a practical alternative to [Alfred](https://www.alfredapp.com/) and [Raycast](https://www.raycast.com/).

![Wox screenshot](https://raw.githubusercontent.com/Wox-launcher/Wox/master/screenshots/app.png)

[View screenshots](https://github.com/Wox-launcher/Wox/tree/master/screenshots)

## Highlights

- Search and launch applications, files, folders, and commands
- AI chat with MCP integration and multiple provider backends
- Extensible plugin system with Python and JavaScript SDKs
- Theme support with online plugin and theme stores
- Cross-platform packaging with no mandatory installation flow

## Install

| Platform | Method | Command or instructions |
| --- | --- | --- |
| macOS / Linux / Windows | Manual | Download the latest package from [Releases](https://github.com/Wox-launcher/Wox/releases) and run it directly |
| macOS | Homebrew | `brew tap wox-launcher/wox && brew install wox` |
| Arch Linux | AUR | `yay -S wox-bin` |

## Default Shortcuts

| Action | Shortcut |
| --- | --- |
| Open or hide Wox | <kbd>Alt</kbd>/<kbd>Command</kbd> + <kbd>Space</kbd> |
| Show item actions | <kbd>Alt</kbd>/<kbd>Command</kbd> + <kbd>J</kbd> |
| Close or go back | <kbd>Esc</kbd> |


## Documentation

- [Project documentation](https://wox-launcher.github.io/Wox/)
- [Plugin store](https://wox-launcher.github.io/Wox/store/plugins.html)
- [Theme store](https://wox-launcher.github.io/Wox/store/themes.html)

## Contributing

Contributions are welcome through issues, discussions, and pull requests.

- [Discussions](https://github.com/Wox-launcher/Wox/discussions)
- [Issues](https://github.com/Wox-launcher/Wox/issues)
- [Pull requests](https://github.com/Wox-launcher/Wox/pulls)

## Sponsors

<table>
  <tr>
    <td width="60" align="center">
      <img src="https://github.com/SignPath.png" width="40" alt="SignPath">
    </td>
    <td>
      Free code signing on Windows provided by <a href="https://signpath.io">SignPath.io</a>, with certificates from <a href="https://signpath.org">SignPath Foundation</a>.
    </td>
  </tr>
</table>

## Project Activity

![Repobeats analytics](https://repobeats.axiom.co/api/embed/1d640adea6ab4acf0b5c7142d256ccd61e97ad30.svg "Repobeats analytics image")