Lenscope

Gaze deeply into unknown regions using the power of the moon 🔭.

Important

Lenscope is currently a work in progress.

The project is still being developed and features, behaviour may change without notice.

Contributions are currently not being accepted. If you'd like to experiment with Lenscope or customise it for your own use, you're welcome to fork the repository, build the project, and package it as a .vsix file for personal use.

Contribution support may be opened in the future once the project has stabilised.

🖼️ Screenshots

What Is Lenscope?

lenscope is a telescope.nvim inspired fuzzy finder for Visual Studio Code powered by ripgrep.

What Is ripgrep?

ripgrep is a line-oriented search tool that recursively searches directories for a regex pattern. By default, ripgrep will respect gitignore rules and automatically skip hidden files/directories and binary files.

Getting Started

VS Code >v1.120.0 or the latest insiders build is required for lenscope to work.

Required dependencies

• ripgrep is required for live_grep and is the first priority for find_files features.

Installing ripgrep

The binary name for ripgrep is rg.

If you're a macOS Homebrew or a Linuxbrew user, then you can install ripgrep from homebrew-core:

$ brew install ripgrep

If you're a Windows Chocolatey user, then you can install ripgrep from the official repo:

$ choco install ripgrep

If you're a Windows Scoop user, then you can install ripgrep from the official bucket:

$ scoop install ripgrep

If you're a Windows Winget user, then you can install ripgrep from the winget-pkgs repository:

$ winget install BurntSushi.ripgrep.MSVC

Development

Prerequisites

• Node.js 24 LTS
• npm
• VS Code
• ripgrep (rg)

Setup

Clone the repository:

$ git clone https://github.com/TBadru/lenscope.git

$ cd lenscope

Use the project's Node version:

$ nvm use

Install dependencies:

$ npm ci

Verify everything is working:

$ npm run check-types

$ npm run lint

$ npm test

Running the Extension

Open the project in VS Code and press:

F5

This launches an Extension Development Host with Lenscope loaded and accessible from the Command palette.

Packaging for Personal Use

If you'd like to use a fork of Lenscope locally, you can package the extension as a .vsix file.

Verify everything is working:

$ npm run package

This generates a .vsix package that can be installed locally in VS Code.

To install the package, open the VS Code Command Palette and run:

Extensions: Install from VSIX...

Then select the generated .vsix file.

Tooling

Lenscope currently uses:

• TypeScript

• Vitest

• ESLint

• esbuild

• npm

The committed package-lock.json is the source of truth for dependency versions.

Features/Functions

Lenscope built-in features/functions soo far;

Functions	Description
live_grep	Search for a string in your current working directory and get results live as you type, respects .gitignore ✅
find_files	Lists files in your current working directory, respects .gitignore ❌
current_buffer_fuzzy_find	Live fuzzy search inside of the currently open buffer ❌

License

MIT