# 🪽 Semble

A [Sublime Text](https://www.sublimetext.com/) plugin that integrates the [`semble`](https://github.com/MinishLab/semble) CLI tool for semantic code search and related-code discovery directly in your editor.

## Features

- **Semantic search** — query your code-base in natural language via the `semble search` CLI
- **Find related** — discover semantically related code snippets
- Results open in a dedicated scratch view rendered as Markdown with syntax-highlighted code blocks
- Inline **"find related"** phantom links on each result for one-click chaining
- Optional **Find Results** tab output - native, clickable file/line navigation

## Requirements

- Sublime Text 4
- [`semble`](https://github.com/MinishLab/semble) CLI installed and on your `PATH` (`uv tool install semble`)
- An open Sublime Text **project** (or single folder window) or set `git_repo`

## Installation

1. Clone or copy this package into your Sublime Text `Packages/` directory:

```shell
git clone https://github.com/debjan/sublime-semble Semble
```

2. Restart Sublime Text.

## Usage

### Semantic search

Open the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`) and type **Semble**. Run the search command and input panel appears:

![semble-input](img/semble-input.png)

Then type your query and press Enter

![semble-search](img/semble-search.png)

### Find related

From the Command Palette, run **Semble: Find Related** to find code related to the current cursor position. You can also click the 🔗 **find related** link that appears beneath any result in the results view to chain searches.

![semble-find-related](img/semble-find-related.png)

Results appear in a **Semble results** tab showing:

- 🎯 Rank (search) or cosine similarity score (find-related)
- 📌 Source file and line range
- 🔗 Find-related link
- Syntax-highlighted code block