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

  • 1.0.1
  • github.​com
  • github.​com
  • 3 months ago
  • 19 minutes ago
  • 3 months ago

Installs

  • Total 63
  • Win 29
  • Mac 17
  • Linux 17
Aug 10 Aug 9 Aug 8 Aug 7 Aug 6 Aug 5 Aug 4 Aug 3 Aug 2 Aug 1 Jul 31 Jul 30 Jul 29 Jul 28 Jul 27 Jul 26 Jul 25 Jul 24 Jul 23 Jul 22 Jul 21 Jul 20 Jul 19 Jul 18 Jul 17 Jul 16 Jul 15 Jul 14 Jul 13 Jul 12 Jul 11 Jul 10 Jul 9 Jul 8 Jul 7 Jul 6 Jul 5 Jul 4 Jul 3 Jul 2 Jul 1 Jun 30 Jun 29 Jun 28 Jun 27
Windows 0 0 0 1 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 2 1 0 0 0 0 1 0 0 0 0 0 3 0 0 1 0 0 2 0 1 1 0 0 0
Mac 0 0 0 0 2 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 1 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 3 0 0 1 0 0 0 0 1 0 1 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.