ZAGROS

01 / Keyboard launcher for Windows

Type less. Launch more.

Zagros opens with one hotkey and finds apps, files, windows, clipboard entries and answers as you type. It is a single native executable, and it is extended with small sandboxed scripts that ask for permission first.

MIT · Go · native Win32 · amd64 and arm64

02 / What it does

Everything you reach for, from the keyboard

Built-in providers cover the daily basics. Everything else is an extension away.

Fuzzy and fast

Type a few letters of an app, file or command. Results are ranked by match quality and by what you actually pick (frecency).

Everything search

Instant file search through voidtools Everything when it is running. No indexer of our own.

Calculator and units

Type 2*(3+4) or 10 km in mi and copy the answer with Enter.

Password generator

Generate strong passwords and passphrases locally. Nothing leaves your machine.

Text tools

Case conversion, encode and decode, hashes, UUIDs, timestamps and more on any text.

Clipboard history

Search what you copied earlier and paste it back.

Window switcher

Jump to any open window by title.

Web search

Keyword searches such as g query. Add your own in the config file.

Emoji

Find an emoji by name and copy it.

Starlark extensions

Write extensions in a small, safe Python-like language. No compile step, hot reload.

Themes in TOML

A theme is one readable file. Switch themes without restarting.

Git marketplace

Install with zagros ext install github:owner/repo. The registry is a Git repository.

03 / Built in

Providers that ship in the box

Each provider can be turned off in the config. Read the reference.

Applications

Start menu, desktop and extra scan folders

Everything

File search through voidtools Everything

Calculator

Expressions, functions, hex and binary

Unit converter

Length, mass, temperature, data, time and more

Passwords

Random passwords and passphrases

Text tools

Transform, encode, hash

Clipboard

Searchable clipboard history

Windows

Switch between open windows

Web search

Configurable keyword searches

Emoji

Search by name

Aliases

Your own keywords for paths, URLs and commands

Extensions

Everything you install

04 / Extensions and permissions

Extensions can only do what you allow

Extensions are Starlark scripts with a manifest. By default they can return results and nothing else. Network, files, clipboard and processes each need a permission, declared in the manifest and approved by you at install, much like on Android. The host checks the grant on every call, and an update that asks for more asks you again.

  • Scoped permissions such as network:api.github.com
  • Review and revoke grants at any time
  • Install from the registry or any github:owner/repo

Permission model Write an extension

Illustration. The real dialog is drawn by the launcher.

05 / Extension example

Declared in a manifest

No SDK, no build step. Drop the folder into your extensions directory or publish it to GitHub. See the extensions guide for the full host API.

manifest.toml
id = "me/hello"name = "Hello"version = "0.1.0"keywords = ["hi"]permissions = ["clipboard.write"]

06 / Themes

Square by default, yours if you want

Themes are TOML files: colours, fonts, row height, border width, corner radius. The built-in themes follow the Boxy design system, and Zagros follows the Windows light and dark setting unless you pick one. Theme reference.

Boxy Light

calc 2^10
=1024Calculator

Boxy Dark

10 km in mi
=6.2137 miUnit converter

Your theme

name = "Mine"radius = 0[colors]show_icons = true

Inspired by Keypirinha

Zagros would not exist without Keypirinha

Keypirinha, by Jean-Charles Lefebvre, is a fast, keyboard-driven launcher for Windows with a package system that many of us have relied on for years. Zagros borrows its spirit: a small window, fuzzy search, extensions you can read. It is an independent project with its own code, and it is not affiliated with Keypirinha.

Visit keypirinha.com

07 / Get it

Download Zagros

Grab the zip for your CPU from the latest release, unzip, run zagros.exe, press Alt + Space.