CodeLens is a precision line & symbol search tool for any text file — a self-contained terminal app and a glassy desktop app, sharing one search engine. Built to avoid the spacing bugs, missing line numbers, and stale caching of an editor's Find box.
No Python install required — the Windows installer bundles both editions, Explorer integration, and an uninstaller. Prefer source? See Requirements below.
Built with Claude Code
%TEMP% on every launch.
Illustrative walkthroughs of the two things you'll do most — searching, and trusting that what you see is never stale.
Type a query, get grouped, highlighted matches with line numbers as you go.
Every search auto-reloads from disk first — edits saved elsewhere show up immediately.
The desktop app imports its matching, comment-fallback, and encoding logic straight from the terminal script — there is exactly one implementation of “does this line match,” not two copies that could quietly drift apart.
colorama is used if present, otherwise raw ANSI.shortcuts.json.Every loaded file is searched at once, grouped per file with match counts — and each search silently reloads any file that changed on disk since it was opened.
Case-sensitive or not. Include a comment in what you type if you need that exact commented line, and nothing else.
Paste a block spanning any number of lines. Falls back automatically to a comment-stripped comparison if the plain match finds nothing.
A specific start-end (or single line) from one loaded file, chunked automatically for very large ranges.
Dark/light and a frosted-glass look, both on by default, both crossfade when switched.
A hand-drawn glassy swatch grid plus hex entry — not the stock OS color dialog.
Every confirm/info box fades and scales in, glass-matched — no native message boxes anywhere.
Detail list, icon grid, or grouped by folder — files sharing a directory collapse into one section.
Drop files anywhere on the window from Explorer to add them to the working set.
Double-click a file for a resizable Formatted/Raw viewer with independent wrap and zoom.
Hide or show the file-list panel; it remembers its width when it comes back.
Search and results split like a file explorer — drag the divider to resize either one.
A separate sortable window: lines, size, encoding, modified time, and full path per file.
Rebind any of these in Settings → Edit Shortcuts; changes persist to shortcuts.json.
| Action | Default |
|---|---|
| Run search | Ctrl + Enter |
| Add file(s) | Alt + A |
| Reload files | Ctrl + R |
| Reset | Ctrl + Shift + R |
| Clear results | Shift + C |
| Toggle case sensitive | Alt + S |
| Zoom in (results / preview) | Ctrl + + |
| Zoom out | Ctrl + – |
| Reset zoom | Ctrl + 0 |
Every icon is a real vector under Assets/ — Qt loads SVG natively, no rasterizer
needed. DarkModeIcons/ and LightModeIcons/ share filenames but not
color; HoverIcons/ is a single white set used the instant a button's background
turns solid, since a themed icon tinted for its resting state disappears against its own
hover color.
CodeLensCLI.py # terminal edition + shared engine CodeLens.py # PySide6 desktop edition shortcuts.json # saved shortcut overrides Assets/ DarkModeIcons/ # SVG icons, dark palette LightModeIcons/ # SVG icons, light palette HoverIcons/ # SVG icons, hover/checked state app_icon.svg # window & brand icon
Needs one package:
pip install PySide6No required third-party dependencies — colorama is used only if already present.