# 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)](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/poster.png)

## 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 | Homebrew | `brew install --cask wox` |
| Windows | Winget | `winget install -e --id Wox.Wox` |
| Windows | Scoop | `scoop install extras/wox` |
| macOS / Linux / Windows | Manual | Download the latest stable package from [Releases](https://github.com/Wox-launcher/Wox/releases) and run it directly |


## 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)
- [Reddit](https://www.reddit.com/r/WoxLauncher/)
- [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")