Windows — winget

winget install yukimemi.shun

Windows — Scoop

scoop bucket add yukimemi https://github.com/yukimemi/scoop-bucket
scoop install yukimemi/shun

macOS — Homebrew

brew tap yukimemi/tap
brew install --cask yukimemi/tap/shun

Direct download — latest installer from Releases:

All options

# Search mode: "fuzzy" (default) | "exact" | "migemo" | "fuzzy_migemo" | "exact_migemo"
search_mode = "fuzzy"

# Sort order: "count_first" (default) | "recent_first"
sort_order = "count_first"

# Auto-hide when the launcher loses focus
hide_on_blur = false

# Start automatically at login (default: true); set to false to disable
auto_start = true

# Update check interval in seconds (0 to disable)
update_check_interval = 3600

# Launcher window width in pixels (default: 620)
window_width = 620

# Max items shown in the results list (default: 8)
max_items = 8

# Max items shown in the completion dropdown (default: 6)
max_completions = 6

# Font size in pixels (default: 14)
# font_size = 14

# Window opacity 0.0–1.0 (default: 1.0)
# opacity = 1.0

# Maximum number of history entries to keep (default: 1000)
# history_max_items = 1000

# Status badge icon style: "unicode" (default) | "svg"
# icon_style = "unicode"

# Monitor to show the launcher on: "cursor" (default) | "primary" | 0 | 1 | ...
# Useful in config.local.toml for per-machine override
# monitor = "cursor"

# Saved window position (set via /save position; delete to reset to default centering)
# position_x = 960.0
# position_y = 300.0

# Preview panel: show when browsing files in args mode (default: true)
# preview_args = true

# Preview panel: show when navigating search results (default: true)
# preview_search = true

# Preview panel width in pixels (default: 400)
# preview_width = 400

# Max lines to load for file preview (default: 500)
# max_preview_lines = 500

# Note: preview panel height is fixed to max_items × item height when visible,
# so increasing max_items also increases the preview panel height.

[keybindings]
launch      = "Ctrl+Space"   # Global hotkey to show/hide
next        = "Ctrl+n"
prev        = "Ctrl+p"
confirm     = "Enter"
arg_mode    = "Tab"
accept_word = "Ctrl+f"      # Accept next word/segment of ghost text
accept_line = "Ctrl+e"      # Accept full ghost text
delete_word = "Ctrl+w"      # Delete word before cursor
delete_line = "Ctrl+u"      # Delete to beginning of line
run_query   = "Shift+Enter" # Run typed query directly (skip history results)
close             = "Escape"
delete_item       = "Ctrl+d"        # Delete selected history/config item
cycle_search_mode = "Ctrl+Shift+m"  # Cycle search mode (fuzzy → exact → migemo)
cycle_sort_order  = "Ctrl+Shift+o"  # Cycle sort order (count_first ↔ recent_first)
toggle_preview    = "Ctrl+Shift+p"  # Toggle file preview panel
preview_scroll_down = "Ctrl+j"      # Scroll preview panel down
preview_scroll_up   = "Ctrl+k"      # Scroll preview panel up

# Logging
[log]
level = "warn"            # "debug" | "info" | "warn" (default) | "error" | "off"
max_file_size_kb = 1024
rotation = "keep_one"     # "keep_one" (default) | "keep_all" | number

# Theme
[theme]
preset = "catppuccin-mocha"   # "catppuccin-mocha" | "catppuccin-latte" | "nord" | "dracula" | "tokyo-night" | "one-half-dark" | "solarized-dark" | "solarized-light"
# bg      = "#1e1e2e"
# surface = "#313244"
# overlay = "#45475a"
# muted   = "#585b70"
# text    = "#cdd6f4"
# blue    = "#89b4fa"
# purple  = "#cba6f7"
# green   = "#a6e3a1"
# red     = "#f38ba8"

# Open editor with file path completion
[[apps]]
name       = "Neovide"
path       = "neovide"
completion = "path"       # "path" | "none" | "list" | "command"

# Search Google (Tab → type query → Enter)
[[apps]]
name = "Google"
path = "https://www.google.com/search?q={{ args | urlencode }}"

# docker exec with container name completion
[[apps]]
name               = "docker exec"
path               = "docker"
args               = ["exec", "-it"]
completion         = "command"
completion_command = "docker ps --format '{{.Names}}'"

# git checkout with branch completion (exact search for this app)
[[apps]]
name                   = "git checkout"
path                   = "git"
args                   = ["checkout"]
completion             = "command"
completion_command     = "git branch --format='%(refname:short)'"
completion_search_mode = "exact"  # "fuzzy" | "exact" | "migemo" (overrides global)
workdir                = "~/src/myproject"

# Override completion for scan_dirs items
[[overrides]]
name            = "scoop"
completion      = "list"
completion_list = ["install", "uninstall", "update", "search", "info"]

# Open .xlsx files with LibreOffice Calc (ext-based override)
[[overrides]]
ext  = "xlsx"                   # match by extension (no dot)
path = "C:/Program Files/LibreOffice/program/scalc.exe"
args = ["{{ file_path }}"]      # pass original file path as arg

# Auto-register scripts from a directory
[[scan_dirs]]
path       = "~/.local/bin"
recursive  = false
extensions = ["sh", "py", "ps1", "cmd"]

[[overrides]] fields:

Override files (config.*.toml)

Any config.*.toml files in the same directory as config.toml are loaded and merged in alphabetical order after the base config. Useful for per-machine or per-context overrides with chezmoi or other dotfile managers.

Examples: config.local.toml, config.work.toml, config.home.toml

Merge rules:

You can use Tera template syntax in the path and args fields. Templates are evaluated at launch time when args are provided via Args mode (Tab).

Context variables:

Override-only variables (available in [[overrides]] path, args, and completion_list when a scanned file is matched — expose the original file's path information for use in templates):

Useful Tera expressions:

Example — Web search:

[[apps]]
name = "Google"
path = "https://www.google.com/search?q={{ args | urlencode }}"

Open shun → goo → Tab → rust borrow checker → Enter → opens the search. Query is saved to history.

Example — Date-stamped memos:

# MemoNew: Tab → type title → Enter → opens "20260321-title.md"
[[apps]]
name       = "MemoNew"
path       = "nvim"
args       = ['~/memo/{{ now() | date(format="%Y%m%d") }}-{{ args }}.md']
completion = "none"

# MemoList: Tab → pick existing memo with migemo path completion → Enter
# (type "hajime" to find "初めて.md")
[[apps]]
name                   = "MemoList"
path                   = "nvim"
args                   = ["~/memo/{{ args }}"]
completion             = "path"
completion_search_mode = "migemo"

Example — User-defined variables:

[vars]
src_dir = "~/src/github.com/yourname"

[[apps]]
name       = "Open Project"
path       = "neovide"
args       = ["{{ vars.src_dir }}/{{ args }}"]
completion = "path"

Example — args_list for multi-argument commands:

# git diff: Tab → "main feature-branch" → Enter → runs "git diff main feature-branch"
[[apps]]
name               = "git diff"
path               = "git"
args               = ["diff", "{{ args_list.0 }}", "{{ args_list.1 | default(value='HEAD') }}"]
completion         = "command"
completion_command = "git branch --format='%(refname:short)'"

# ripgrep with comma-separated globs: Tab → "*.rs *.toml" → passes as separate args
[[apps]]
name = "rg"
path = "rg"
args = ["--glob={{ args_list | join(sep=',') }}"]

Switch theme for the current session with /theme <name> (Tab to pick). To persist across restarts, set it in config.toml:

[theme]
preset = "nord"
bg     = "#1a1a2e"  # optional per-color override

Built-in presets:

Color keys (all optional — unset keys fall back to the preset):

All keybindings are configurable via [keybindings] in config.toml. Changes take effect after /reload — no restart needed.

• In-app keys use KeyboardEvent.key values
• The global launch shortcut uses global-hotkey key codes

Search mode (default keys):

Args mode (default keys):

Special input:

# Prerequisites: Node.js, Rust

git clone https://github.com/yukimemi/shun
cd shun
npm install
npm run tauri dev     # development
npm run tauri build   # production build