> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the Full-Text Search Launcher

> Linkly AI provides a powerful full-text search launcher to help you quickly find the documents you need.

## Launcher Introduction

The Linkly AI Launcher is a global search window, similar to macOS Spotlight or Raycast. You can invoke it at any time with a keyboard shortcut and enter keywords or natural language to search your local documents.

Linkly AI's search capability uses a hybrid retrieval algorithm based on keywords and semantics — it not only matches keywords precisely but also understands your search intent to find semantically related documents.

<CardGroup cols={2}>
  <Card title="Keyword search" icon="magnifying-glass" iconType="duotone">
    Enter precise keywords to quickly match document titles and content
  </Card>

  <Card title="Semantic search" icon="brain" iconType="duotone">
    Describe what you're looking for in natural language — AI understands the
    semantics and returns relevant documents
  </Card>
</CardGroup>

## How to Use

<Steps>
  <Step title="Invoke the Launcher">
    Press the global shortcut `⌘ + Shift + L` (macOS) or `Ctrl + Shift + L` (Windows/Linux) to instantly bring up the Launcher.

    <Tip>
      You can customize the shortcut in Settings → General → Search Shortcut.
    </Tip>
  </Step>

  <Step title="Enter your search">
    Type keywords or a natural language description in the search box. The system searches automatically as you type — no need to press Enter.

    **Search examples:**

    * Exact search: `API design document`
    * Natural language: `notes about team collaboration workflow`
    * Multiple keywords: `React performance optimization best practices`
  </Step>

  <Step title="Browse search results">
    Search results appear in real time. Each result includes:

    * **Document icon** — Displays the corresponding icon based on file type (PDF, DOCX, MD, etc.)
    * **Title** — The document filename
    * **Content snippet** — Matching body text fragment with search terms highlighted
    * **File path** — The document's location
    * **Relevance** — Shown as a percentage

    Use `↑` `↓` arrow keys to navigate between results.
  </Step>

  <Step title="Preview a document">
    Select a result and press `Enter` to open the document preview. The preview provides:

    * **Full content** — Complete document text with search terms highlighted throughout
    * **Auto-positioning** — Automatically scrolls to the first match
    * **Metadata drawer** — Press `⌘ + I` to expand the metadata panel, showing file size, word count, creation date, keywords, and other details
  </Step>

  <Step title="Open the file">
    In the search results or preview, press `Shift + Enter` to open the file with the system default application. You can also press `⌘ + Shift + C` to copy the file path.
  </Step>
</Steps>

### Search History

When the search box is empty, the Launcher displays your recent search history (up to 20 entries). Click any history entry to quickly re-run that search.

Click the clear button next to the history to clear all history at once.

## Keyboard Shortcuts

### Global Shortcut

| Shortcut                                                     | Function        |
| ------------------------------------------------------------ | --------------- |
| `⌘ + Shift + L` (macOS) / `Ctrl + Shift + L` (Windows/Linux) | Toggle Launcher |

### Search View

| Shortcut        | Function                          |
| --------------- | --------------------------------- |
| `↑` / `↓`       | Navigate between search results   |
| `Enter`         | Preview selected document         |
| `Shift + Enter` | Open file with system default app |
| `⌘ + Shift + C` | Copy file path                    |
| `⌘ + ,`         | Open Settings                     |
| `Esc`           | Close Launcher                    |

### Preview View

| Shortcut            | Function                          |
| ------------------- | --------------------------------- |
| `Shift + Enter`     | Open file with system default app |
| `⌘ + Shift + C`     | Copy file path                    |
| `⌘ + I`             | Toggle metadata panel             |
| `⌘ + ,`             | Open Settings                     |
| `Esc` / `Backspace` | Return to search results          |

<Note>
  In the tables above, `⌘` corresponds to `Ctrl` on Windows and Linux.
</Note>