### Quick Start Examples for Converter Plugin

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/plugins/system/converter.md

Demonstrates various conversion queries supported by the Converter plugin, including units, currencies, crypto, and math.

```text
1km to m
100lb to kg
32 bytes to gb
32bytes =? gb
1 GB to MiB
1 btc to usd
100 usd + 50 usd
```

--------------------------------

### Quick Start Example

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/plugins/system/websearch.md

Demonstrates how to use the WebSearch plugin with a keyword. The default configuration includes Google with the 'g' keyword.

```text
Wox Launcher
g Wox Launcher
```

--------------------------------

### Example Command Query

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/usage/querying.md

Run a command within a plugin by specifying the plugin's trigger, the command, and any necessary arguments. For instance, 'wpm install browser' installs the 'browser' plugin using the Plugin Manager.

```text
wpm install browser
```

--------------------------------

### File Plugin Quick Start Examples

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/plugins/system/file.md

Use the 'f' keyword followed by a file name, extension, or folder hint to search for files and folders. The first run may show indexing status.

```text
f report
f README.md
f Documents invoice
f .pdf
```

--------------------------------

### Basic CMake Project Setup

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/linux/runner/CMakeLists.txt

Initializes CMake and defines the project name and languages. This is a standard starting point for CMake projects.

```cmake
cmake_minimum_required(VERSION 3.13)
project(runner LANGUAGES CXX)
```

--------------------------------

### Install wox-plugin

Source: https://github.com/wox-launcher/wox/blob/master/wox.plugin.nodejs/README.md

Install the wox-plugin package using npm.

```bash
npm install wox-plugin
```

--------------------------------

### Open Plugin Manager Deep Link

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/usage/deep-link.md

Example of a deep link to open Wox and search for the 'wpm install' command in the Plugin Manager.

```text
wox://query?q=wpm%20install
```

--------------------------------

### Plugin Configuration Example

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/plugins/specification.md

A complete example of a plugin.json file, demonstrating the structure and common fields used to configure a Wox plugin.

```json
{
  "Id": "cea0fdfc6d3b4085823d60dc76f28855",
  "Name": "Calculator",
  "Description": "Quick math in the launcher",
  "Author": "Wox Team",
  "Version": "1.0.0",
  "MinWoxVersion": "2.0.0",
  "Runtime": "PYTHON",
  "Entry": "main.py",
  "Icon": "emoji:🧮",
  "TriggerKeywords": ["calc"],
  "SupportedOS": ["Windows", "Darwin", "Linux"],
  "Features": [{ "Name": "debounce", "Params": { "IntervalMs": "250" } }, { "Name": "ai" }],
  "SettingDefinitions": [
    {
      "Type": "textbox",
      "Value": {
        "Key": "api_key",
        "Label": "API Key",
        "Tooltip": "Get it from your provider",
        "DefaultValue": ""
      }
    }
  ]
}
```

--------------------------------

### Install Wox with Winget on Windows

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/installation.md

Use this command to install Wox on Windows via Winget.

```bash
winget install -e --id Wox.Wox
```

--------------------------------

### Preview Documentation Locally

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/contributing.md

Navigate to the www directory and install dependencies to preview documentation locally.

```bash
cd www
pnpm install
pnpm docs:dev
```

--------------------------------

### Install wox-plugin using pip

Source: https://github.com/wox-launcher/wox/blob/master/wox.plugin.python/README.md

Install the wox-plugin package using pip.

```bash
pip install wox-plugin
```

--------------------------------

### Install Wox with Scoop on Windows

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/installation.md

Use this command to install Wox on Windows via Scoop.

```bash
scoop install extras/wox
```

--------------------------------

### Install Dependencies for Wox Documentation Site

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/setup.md

Run this command in the `www` directory to install the necessary Node.js packages for the documentation site.

```bash
cd www
pnpm install
```

--------------------------------

### Install Application Executable

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/windows/CMakeLists.txt

Installs the application executable to the specified runtime destination.

```cmake
install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)
```

--------------------------------

### Install wox-plugin using uv

Source: https://github.com/wox-launcher/wox/blob/master/wox.plugin.python/README.md

Install the wox-plugin package using uv, the recommended package manager.

```bash
uv add wox-plugin
```

--------------------------------

### Start Linux Host and Initialize Renderer

Source: https://github.com/wox-launcher/wox/blob/master/docs/superpowers/plans/2026-04-15-go-native-launcher-runtime.md

Initializes the Linux host window and its associated renderer. Ensure the context is valid before calling.

```go
func (h *LinuxHost) Start(ctx context.Context) error {
	if err := h.createWindow(ctx); err != nil {
		return err
	}
	return h.renderer.Initialize(ctx, h.window)
}
```

--------------------------------

### Clone and Setup Wox Repository

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/contributing.md

Clone your fork of the Wox repository and set up the development environment.

```bash
git clone https://github.com/YOUR-USERNAME/Wox.git
cd Wox
make dev
```

--------------------------------

### Example Search Queries

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/plugins/system/browser-bookmark.md

These are example queries you can type into Wox to find bookmarks. The plugin uses fuzzy matching for titles and exact partial matching for URLs.

```text
github
docs
wox launcher
github.com/Wox-launcher
```

--------------------------------

### Python Example: Using Settings

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/plugins/script-plugin.md

Demonstrates how to access and use settings like API keys from environment variables in a Python script plugin.

```python
if api_key:
    print(f"Using API key: {api_key[:4]}...")
```

--------------------------------

### Wox Python Plugin Example

Source: https://github.com/wox-launcher/wox/blob/master/wox.plugin.python/README.md

A basic Wox plugin class demonstrating the `init` and `query` methods. This example returns a `QueryResponse` object, suitable for Wox versions 2.0.4 and newer.

```python
from wox_plugin import Query, QueryResponse, Result, Context, PluginInitParams, WoxImage

class MyPlugin:
    async def init(self, ctx: Context, params: PluginInitParams) -> None:
        self.api = params.API
        
    async def query(self, ctx: Context, query: Query) -> QueryResponse:
        # Your plugin logic here
        results = []
        results.append(
            Result(
                title="Hello Wox",
                sub_title="This is a sample result",
                icon=WoxImage.new_emoji("🔍"),
                score=100
            )
        )
        return QueryResponse(results=results)

# MUST HAVE! The plugin class will be automatically loaded by Wox
plugin = MyPlugin()
```

--------------------------------

### Install Wox with Homebrew on macOS

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/installation.md

Use this command to install Wox on macOS via Homebrew.

```bash
brew install --cask wox
```

--------------------------------

### Install Bundled Plugin Libraries

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/windows/CMakeLists.txt

Installs any bundled plugin libraries to the root of the bundle directory, if they exist.

```cmake
if(PLUGIN_BUNDLED_LIBRARIES)
  install(FILES "${PLUGIN_BUNDLED_LIBRARIES}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()
```

--------------------------------

### JavaScript Example: Using Settings

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/plugins/script-plugin.md

Shows how to retrieve and utilize settings such as API keys and feature flags from environment variables in a JavaScript script plugin.

```javascript
// Get setting value
const apiKey = process.env.WOX_SETTING_API_KEY || "";
const enableFeature = process.env.WOX_SETTING_ENABLE_FEATURE === "true";
const outputFormat = process.env.WOX_SETTING_OUTPUT_FORMAT || "json";

// Use the settings
if (apiKey) {
  console.log(`Using API key: ${apiKey.substring(0, 4)}...`);
}
```

--------------------------------

### Launch App Grid in Wox

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/blog/did-you-know-wox-app-launchpad.md

Run this command in Wox to switch the App plugin to a grid layout, displaying installed applications as icons.

```text
app launchpad
```

--------------------------------

### Install Wox with AUR on Arch Linux

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/installation.md

Use this command to install Wox on Arch Linux via an AUR helper like yay.

```bash
yay -S wox-bin
```

--------------------------------

### Installation: Clean Build Bundle

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/linux/CMakeLists.txt

Removes the build bundle directory before installation to ensure a clean state.

```cmake
install(CODE "
  file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\")
  " COMPONENT Runtime)
```

--------------------------------

### Example Keyword Query

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/usage/querying.md

Use a keyword to send a query to a specific plugin. For example, 'f invoice' sends the query to the file search plugin.

```text
f invoice
```

--------------------------------

### Quick Start Chat Command

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/plugins/system/chat.md

Initiate an AI conversation by typing 'chat' followed by your query in Wox.

```text
chat How do I use Wox?
```

--------------------------------

### Basic TypeScript Plugin Example

Source: https://github.com/wox-launcher/wox/blob/master/wox.plugin.nodejs/README.md

A basic Wox plugin implemented in TypeScript. This example demonstrates how to initialize the plugin and handle queries, returning results with actions. Ensure your plugin.json specifies MinWoxVersion >= 2.0.4 for QueryResponse.

```typescript
import { Plugin, Context, Query, QueryResponse, Result, NewContext, WoxImage } from "wox-plugin"

class MyPlugin implements Plugin {
  private api: PublicAPI

  async init(ctx: Context, initParams: PluginInitParams): Promise<void> {
    this.api = initParams.API
    await this.api.Log(ctx, "Info", "MyPlugin initialized")
  }

  async query(ctx: Context, query: Query): Promise<QueryResponse> {
    const results: Result[] = []

    for (const item of this.getItems(query.Search)) {
      results.push({
        Title: item.name,
        SubTitle: item.description,
        Icon: { ImageType: "emoji", ImageData: "🔍" },
        Score: 100,
        Actions: [
          {
            Name: "Open",
            Icon: { ImageType: "emoji", ImageData: "🔗" },
            IsDefault: true,
            Action: async (ctx, actionCtx) => {
              await this.openItem(item)
            }
          }
        ]
      })
    }

    return { Results: results }
  }
}
```

--------------------------------

### Basic CMake Setup

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/windows/flutter/CMakeLists.txt

Sets the minimum CMake version and defines the ephemeral directory. This is standard boilerplate for CMake projects.

```cmake
cmake_minimum_required(VERSION 3.14)

set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral")

# Configuration provided via flutter tool.
include(${EPHEMERAL_DIR}/generated_config.cmake)
```

--------------------------------

### Image Type Examples

Source: https://github.com/wox-launcher/wox/blob/master/wox.plugin.nodejs/README.md

Examples demonstrating how to specify different image types for plugin results, including emoji, base64 encoded images, and relative paths.

```typescript
// Emoji icon
{ ImageType: "emoji", ImageData: "🔍" }
```

```typescript
// Base64 image
{ ImageType: "base64", ImageData: "data:image/png;base64,iVBORw0..." }
```

```typescript
// Relative path
{ ImageType: "relative", ImageData: "./icons/icon.png" }
```

--------------------------------

### Start AI Chat Deep Link

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/usage/deep-link.md

Example of a deep link to open Wox and start an AI chat with a specific prompt.

```text
wox://query?q=chat%20summarize%20this
```

--------------------------------

### Example Git Commit Message Command Prompt

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/ai/commands.md

This prompt guides the AI to generate a Git commit message based on a provided diff, adhering to specific formatting rules. It uses '%s' as a placeholder for the input diff.

```text
Write a Git commit message for this diff.

Rules:
- First line: imperative mood, 50 characters or fewer.
- Then a blank line.
- Then 2-3 bullet points explaining the concrete changes.
- Output only the commit message.

Diff:
%s
```

--------------------------------

### Run Wox Documentation Site Locally

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/setup.md

Navigate to the `www` directory and run this command to preview the documentation site locally.

```bash
cd www
pnpm docs:dev
```

--------------------------------

### Bootstrap Wox Development Environment

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/setup.md

Run this command from the repository root to check dependencies, prepare resource folders, and build the core components and plugin hosts.

```bash
make dev
```

--------------------------------

### Install Flutter Library

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/windows/CMakeLists.txt

Installs the Flutter library file to the root of the bundle directory.

```cmake
install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)
```

--------------------------------

### Bash Example: Using Settings

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/plugins/script-plugin.md

Illustrates how to read and apply settings like API keys and feature flags from environment variables within a Bash script plugin.

```bash
# Get setting value
API_KEY="${WOX_SETTING_API_KEY:-}"
ENABLE_FEATURE="${WOX_SETTING_ENABLE_FEATURE:-false}"
OUTPUT_FORMAT="${WOX_SETTING_OUTPUT_FORMAT:-json}"

# Use the settings
if [ -n "$API_KEY" ]; then
    echo "Using API key: ${API_KEY:0:4}..."
fi
```

--------------------------------

### Conventional Commit Examples

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/contributing.md

Examples of commit messages following the Conventional Commits specification.

```bash
git commit -m "feat(plugin): add screenshot API"
git commit -m "fix(webview): restore open in browser action"
git commit -m "docs(development): refresh contributor setup guide"
```

--------------------------------

### Build Go Backend for Wox

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/setup.md

Use this command to build the Go backend (`wox.core`) when working on plugin runtime, built-in plugins, or settings.

```bash
make -C wox.core build
```

--------------------------------

### Install ICU Data File

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/windows/CMakeLists.txt

Installs the ICU data file to the data directory within the bundle.

```cmake
install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)
```

--------------------------------

### Installation: Native Assets

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/linux/CMakeLists.txt

Installs native assets provided by packages to the application's library directory.

```cmake
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)
```

--------------------------------

### Install AOT Library

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/windows/CMakeLists.txt

Installs the Ahead-Of-Time (AOT) compiled library to the data directory, but only for Profile and Release configurations.

```cmake
install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  CONFIGURATIONS Profile;Release
  COMPONENT Runtime)
```

--------------------------------

### Generate Production Build for Wox Documentation Site

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/setup.md

Navigate to the `www` directory and run this command to generate a production-ready build of the documentation site.

```bash
cd www
pnpm docs:build
```

--------------------------------

### Installation: Bundled Plugin Libraries

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/linux/CMakeLists.txt

Installs bundled libraries provided by plugins to the application's library directory.

```cmake
foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES})
  install(FILES "${bundled_library}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endforeach(bundled_library)
```

--------------------------------

### Set Installation Prefix for Bundle

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/windows/CMakeLists.txt

Configures the installation prefix to be next to the executable for running in place, especially for Visual Studio builds.

```cmake
set(BUILD_BUNDLE_DIR "$<TARGET_FILE_DIR:${BINARY_NAME}>")
set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1)
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}")
```

--------------------------------

### Run Full Backend Build Verification

Source: https://github.com/wox-launcher/wox/blob/master/docs/superpowers/plans/2026-04-16-query-session-stability-phase1.md

Executes the Go build command for all packages and the make build command to verify the backend build. Ensure you are in the correct directory.

```bash
cmd.exe /c "cd /d C:\\dev\\Wox\\wox.core && go build ./..."
cd /mnt/c/dev/Wox/wox.core && make build
```

--------------------------------

### Run Native Launcher Preview Smoke Test

Source: https://github.com/wox-launcher/wox/blob/master/docs/superpowers/plans/2026-04-15-go-native-launcher-runtime.md

Commands to navigate to the Wox.core directory, run the native launcher preview smoke test, and build the project. Used to verify preview functionality.

```bash
cd /mnt/c/dev/Wox/wox.core
go test ./test -run TestNativeLauncherQueryPreview -count=1
make build
```

--------------------------------

### Minimal Python Plugin Example

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/plugins/full-featured-plugin.md

A basic Python plugin demonstrating initialization and query handling. Ensure `MinWoxVersion` is set to `2.0.4` or newer in `plugin.json` to use `QueryResponse`.

```python
from wox_plugin import Plugin, Query, QueryResponse, Result, Context, PluginInitParams
from wox_plugin.models.image import WoxImage

class MyPlugin(Plugin):
    async def init(self, ctx: Context, params: PluginInitParams) -> None:
        self.api = params.api
        self.plugin_dir = params.plugin_directory

    async def query(self, ctx: Context, query: Query) -> QueryResponse:
        return QueryResponse(results=[
            Result(
                title="Hello Wox",
                sub_title="This is a sample result",
                icon=WoxImage.new_emoji("👋"),
                score=100,
            )
        ])

plugin = MyPlugin()
```

--------------------------------

### Conditional AOT Library Installation

Source: https://github.com/wox-launcher/wox/blob/master/wox.ui.flutter/wox/linux/CMakeLists.txt

Installs the AOT library to the specified destination only for non-Debug build types. Ensures runtime components are correctly placed.

```cmake
if(NOT CMAKE_BUILD_TYPE MATCHES "Debug")
  install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()
```

--------------------------------

### Implement Windows Host with Direct2D/DirectWrite

Source: https://github.com/wox-launcher/wox/blob/master/docs/superpowers/plans/2026-04-15-go-native-launcher-runtime.md

Implements the WindowsHost struct with methods to create a native window, initialize the renderer, and present the initial frame using Direct2D and DirectWrite.

```go
type WindowsHost struct {
	dispatcher *windowsDispatcher
	renderer   render.Renderer
}

func (h *WindowsHost) Start(ctx context.Context) error {
	if err := h.createWindow(ctx); err != nil {
		return err
	}
	if err := h.renderer.Initialize(ctx, h.hwnd); err != nil {
		return err
	}
	return h.renderer.Present(ctx, h.bootstrapFrame)
}
```

--------------------------------

### ResultAction Example

Source: https://github.com/wox-launcher/wox/blob/master/wox.plugin.nodejs/README.md

An example of defining a `ResultAction` for a plugin result. This specific action is for copying content to the clipboard, with a defined name, icon, hotkey, and action handler.

```typescript
ResultAction({
  name: "Copy",
  icon: { ImageType: "emoji", ImageData: "📋" },
  isDefault: true,
  hotkey: "Ctrl+C",
  action: async (ctx, actionCtx) => {
    await this.copyToClipboard(actionCtx.contextData)
  }
})
```

--------------------------------

### Launch Native Launcher for Testing

Source: https://github.com/wox-launcher/wox/blob/master/docs/superpowers/plans/2026-04-15-go-native-launcher-runtime.md

Helper function to launch the native Wox launcher for testing purposes. It initializes core services, starts the runtime, and returns an automation client for interacting with the launcher. Derived from `wox.core/test/native_launcher_test_helper.go`.

```go
func launchNativeLauncherForTest(t *testing.T) *launcherdebug.Automation {
	ctx := util.NewTraceContext()
	services, err := app.StartCoreServices(ctx, 0)
	require.NoError(t, err)
	runtime := launcher.NewForTest(services)
	require.NoError(t, runtime.Start(ctx))
	return launcherdebug.NewAutomation(runtime)
}
```

--------------------------------

### Fallback Result Examples

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/usage/querying.md

Some plugins respond to general text input without requiring a keyword. Examples include typing 'Chrome', '100 + 20', or '1km to m' for direct results.

```text
Chrome
```

```text
100 + 20
```

```text
1km to m
```

--------------------------------

### Script Plugin with Setting Definitions

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/plugins/script-plugin.md

This example demonstrates defining various setting types for a script plugin, including textbox, select, and checkbox. These settings allow users to configure plugin behavior through the Wox settings UI.

```python
#!/usr/bin/env python3
# {
#   "Id": "weather-plugin",
#   "Name": "Weather",
#   "TriggerKeywords": ["weather"],
#   "SettingDefinitions": [
#     {
#       "Type": "textbox",
#       "Value": {
#         "Key": "api_key",
#         "Label": "API Key",
#         "Tooltip": "Your weather API key",
#         "DefaultValue": "",
#         "Style": {
#           "Width": 400
#         }
#       }
#     },
#     {
#       "Type": "select",
#       "Value": {
#         "Key": "units",
#         "Label": "Temperature Units",
#         "DefaultValue": "celsius",
#         "Options": [
#           {"Label": "Celsius", "Value": "celsius"},
#           {"Label": "Fahrenheit", "Value": "fahrenheit"}
#         ]
#       }
#     },
#     {
#       "Type": "checkbox",
#       "Value": {
#         "Key": "show_forecast",
#         "Label": "Show 7-day forecast",
#         "DefaultValue": "true"
#       }
#     }
#   ]
# }
```

--------------------------------

### Run Linux Native Launcher Smoke Tests

Source: https://github.com/wox-launcher/wox/blob/master/docs/superpowers/plans/2026-04-15-go-native-launcher-runtime.md

Executes the native launcher smoke tests on Linux. This command navigates to the wox.core directory, runs Go tests with a specific filter, and then builds the project. Ensure you are in the correct directory before execution.

```bash
cd /mnt/c/dev/Wox/wox.core
go test ./test -run TestNativeLauncherLinux -count=1
make build
```

--------------------------------

### Document Writing Emoji Usage

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/plugins/system/emoji.md

Examples of using the emoji plugin to enhance documents.

```text
note
→ 📝

warning
→ ⚠️

important
→ ⭐
```

--------------------------------

### Open Setting Window in Go

Source: https://github.com/wox-launcher/wox/blob/master/docs/superpowers/plans/2026-04-15-go-native-launcher-runtime.md

Implements the `OpenSettingWindow` function in Go, responsible for launching or focusing the settings application. This function is designed to be independent of the main launcher's WebSocket communication.

```go
func (m *Manager) OpenSettingWindow(ctx context.Context, windowContext common.SettingWindowContext) error {
	appPath := util.GetLocation().GetUIAppPath()
	_, err := shell.Run(appPath, "--settings", fmt.Sprintf("%d", m.serverPort), windowContext.Path, windowContext.Param)
	return err
}
```

--------------------------------

### Table and Dynamic Setting Example

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/plugins/specification.md

Configures a section for mappings with an editable table for key-value rules and a dynamic setting placeholder. The table has defined columns and default values, while the dynamic setting is intended to be populated at runtime.

```json
{
  "SettingDefinitions": [
    { "Type": "head", "Value": "Mappings" },
    {
      "Type": "table",
      "Value": {
        "Key": "rules",
        "Tooltip": "Key/value rules",
        "Columns": [
          { "Title": "Key", "Width": 150 },
          { "Title": "Value", "Width": 240 }
        ],
        "DefaultValue": [
          ["foo", "bar"],
          ["hello", "world"]
        ]
      }
    },
    {
      "Type": "dynamic",
      "Value": {
        "Key": "runtime_options"
      }
    }
  ]
}
```

--------------------------------

### Task Management Emoji Usage

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/guide/plugins/system/emoji.md

Examples of using the emoji plugin to mark task status.

```text
todo
→ 📝

done
→ ✅

in progress
→ 🚧
```

--------------------------------

### Build Python Plugin Host for Wox

Source: https://github.com/wox-launcher/wox/blob/master/www/docs/development/setup.md

Execute this command to build the Python plugin host, useful for faster iteration when only changing host or runtime behavior.

```bash
make -C wox.plugin.host.python build
```