Skip to content

AreChen/CmdPal-LinkSearch

Repository files navigation

LinkSearch logo

LinkSearch

Search Linkwarden from Microsoft PowerToys Command Palette.

Find saved links, open pages quickly, and optionally rerank results with a semantic Rerank API.

English | 简体中文

Get it from Microsoft Store Latest release .NET 9 License MIT

InstallFeaturesUsageRerank APIPrivacy


Preview

LinkSearch search preview in PowerToys Command Palette

LinkSearch settings page

Features

Search icon

Fast Search

Search Linkwarden collections directly from PowerToys Command Palette.

Open link icon

Quick Open

Open saved pages from search results without switching context.

Rerank icon

Optional Rerank

Connect a configurable Rerank API for better semantic ordering.

Language icon

Bilingual UI

Use Auto, Simplified Chinese, or English from extension settings.

Install

LinkSearch requires Microsoft PowerToys with Command Palette support.

Get it from Microsoft Store

  • Recommended: install LinkSearch from the Microsoft Store.
  • Fallback: download the latest GitHub Release MSIX sideload package if Microsoft Store is unavailable.

Usage

  1. Open PowerToys CmdPal (Command Palette).
  2. Go to the extension settings page and enable the LinkSearch extension.
  3. Configure your preferred shortcut key for the extension.
  4. Configure Linkwarden server address, access token, and maximum search result count.
  5. Choose the interface language: Auto, Simplified Chinese, or English.
  6. Optional: enable and configure Rerank service parameters, such as API URL, key, and model name.
  7. Enter the shortcut key and start searching.

Rerank API

LinkSearch is designed to work with services that expose a compatible rerank endpoint.

Request example:

curl --location 'https://rerank-api.provider.com/v1/rerank' \
  --header 'Authorization: Bearer your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "bge-reranker-v2-m3",
    "query": "What is Corona disease?",
    "documents": [
      "Corona is a Mexican brand of beer produced by Grupo Modelo in Mexico and exported to markets around the world.",
      "it is a bear",
      "COVID-19 is a contagious illness caused by the a virus SARS-CoV-2."
    ]
  }'

Response example:

{
  "results": [
    {
      "index": 2,
      "relevance_score": 0.3174557089805603
    },
    {
      "index": 0,
      "relevance_score": 0.017295653000473976
    },
    {
      "index": 1,
      "relevance_score": 0.000016235228031291626
    }
  ],
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 0,
    "total_tokens": 50,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 0,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    },
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": null
  }
}

Roadmap

  • Microsoft Store publishing.

Credits

  • Built on the PowerToys CmdPal extension framework (Microsoft Command Palette Extensions Toolkit).
  • Semantic reranking capability aligns with modern retrieval engineering practices, thanks to community resources and examples.

Contributing

Issues and pull requests are welcome.

Privacy

Privacy Policy

License

MIT

About

A cmdpal extension for searching the contents of your Linkwarden instance, featuring reranking to enhance the retrieval experience.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors