ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

LSP-addon-breadcrumb

by huyhoang8398 ST3

A clean and interactive breadcrumb that shows both the file path and the current symbol hierarchy at the top of the editor.

Labels file, utilities, tooltips, breadcrumb

Details

Installs

  • Total 31
  • Win 12
  • Mac 12
  • Linux 7
Jun 10 Jun 9 Jun 8 Jun 7 Jun 6 Jun 5 Jun 4 Jun 3 Jun 2 Jun 1 May 31 May 30 May 29 May 28 May 27 May 26 May 25 May 24 May 23 May 22 May 21 May 20 May 19 May 18 May 17 May 16 May 15 May 14 May 13 May 12 May 11 May 10 May 9 May 8 May 7 May 6 May 5 May 4 May 3 May 2 May 1 Apr 30 Apr 29 Apr 28 Apr 27
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 2 1 0 0 0 1 0 0 1 1 2 1 1 0 1 0 1 0 0 0 0 0 0 0
Mac 0 0 1 0 0 0 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 1 2 1 0 0 0 0 0 0 0 0 1 1 2 1 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 2 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 1 0 0 0 0 0 0 0 1 0 0 0 1 1 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Breadcrumb for Sublime Text

A clean and interactive breadcrumb that shows both the file path and the current symbol hierarchy at the top of the editor.

Powered by the LSP plugin for accurate, real-time symbol navigation.

Features

  • Always visible at the top of the view
  • Real-time updates as you move the cursor
  • Lightweight and fast
  • Works great with Pyright, rust-analyzer, TypeScript, clangd, gopls, etc.

What it does

Whenever you move the cursor, open a file, or switch tabs, a small popup appears at the top of the editor showing where you are:

📂 ~ › projects › myapp › src › utils.py › MyClass › render

Default behaviour (no dependencies)

Out of the box, with no extra packages installed, the plugin works standalone and shows:

  • File path breadcrumb — the last 5 segments of the current file's path, with ~ substituted for your home directory. That's it. The popup fires on cursor move, file load, save, and tab switch.

With LSP — symbol context

If you have the LSP package installed, the plugin will also show symbol context: the chain of symbols (class, function, method, block…) that enclose your cursor, queried live from your language server.

📂 ~ › projects › myapp › src › utils.py › MyClass › render

Without LSP, the symbol portion is simply absent — the file breadcrumb still shows normally.

Recommendation: Install LSP for the full experience. Without it the plugin is still useful, but you lose the most valuable part.

Setting up LSP

  1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
  2. Run Package Control: Install Package
  3. Search for and install LSP
  4. Install a language server for your language, for example:
    • LSP-pyright for Python
    • LSP-typescript for TypeScript / JavaScript
    • LSP-clangd for C / C++
    • LSP-rust-analyzer for Rust The plugin automatically picks the best LSP session for the active file and uses documentSymbols to build the context chain. No extra configuration needed.

Manual Installation

  1. Download or clone this repository
  2. Copy the folder into Sublime Text's Packages directory:
    • Menu → Preferences → Browse Packages…
  3. Restart Sublime Text (or run Package Control: Satisfy Dependencies)

Usage

  • The breadcrumb appears automatically when you open a file with an active LSP session.
  • Click on any part of the file path to open that folder.
  • The display updates live on cursor movement.