Metadata-Version: 2.5
Name: jupyterlab_terminal_show_in_file_browser_extension
Version: 1.0.27
Summary: Jupyterlab extension to add context menu item to the terminal tab to navigate file browser to the pwd path of the terminal
Project-URL: Homepage, https://github.com/stellarshenson/jupyterlab_terminal_show_in_file_browser_extension
Project-URL: Bug Tracker, https://github.com/stellarshenson/jupyterlab_terminal_show_in_file_browser_extension/issues
Project-URL: Repository, https://github.com/stellarshenson/jupyterlab_terminal_show_in_file_browser_extension.git
Author-email: Stellars Henson <konrad.jelen@gmail.com>
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: jupyter,jupyterlab,jupyterlab-extension
Classifier: Framework :: Jupyter
Classifier: Framework :: Jupyter :: JupyterLab
Classifier: Framework :: Jupyter :: JupyterLab :: 4
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: jupyter-builder<2,>=1.2; extra == 'dev'
Requires-Dist: jupyterlab<5,>=4.6; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest-cov<8,>=7.1; extra == 'test'
Requires-Dist: pytest<10,>=9.1; extra == 'test'
Description-Content-Type: text/markdown

# jupyterlab_terminal_show_in_file_browser_extension

[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_terminal_show_in_file_browser_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_terminal_show_in_file_browser_extension/actions/workflows/build.yml)
[![npm version](https://img.shields.io/npm/v/jupyterlab_terminal_show_in_file_browser_extension.svg)](https://www.npmjs.com/package/jupyterlab_terminal_show_in_file_browser_extension)
[![PyPI version](https://img.shields.io/pypi/v/jupyterlab-terminal-show-in-file-browser-extension.svg)](https://pypi.org/project/jupyterlab-terminal-show-in-file-browser-extension/)
[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-terminal-show-in-file-browser-extension)](https://pepy.tech/project/jupyterlab-terminal-show-in-file-browser-extension)
[![JupyterLab 4](https://img.shields.io/badge/JupyterLab-4-orange.svg)](https://jupyterlab.readthedocs.io/en/stable/)
[![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)

> [!TIP]
> This extension is part of the [stellars_jupyterlab_extensions](https://github.com/stellarshenson/stellars_jupyterlab_extensions) metapackage. Install all Stellars extensions at once: `pip install stellars_jupyterlab_extensions`

Navigate the file browser to your terminal's current working directory with a single click. Right-click on any terminal tab and select "Show in File Browser" to instantly jump to the directory where your terminal session is working.

**Full disclosure:** This extension does exactly one thing. It's not revolutionary, it won't change your life, and it definitely won't impress anyone at parties. But every time you `cd` somewhere and wonder "where am I again?" - it'll be there for you. Quietly. Unremarkably. Like a good friend who never asks for credit.

![Show in File Browser](.resources/screenshot.png)

## Features

- **Context menu on terminal tabs** - Right-click any terminal tab to reveal "Show in File Browser" option
- **Context menu in terminal area** - Also available when right-clicking inside the terminal
- **Server-side cwd detection** - Accurately determines terminal's working directory via process inspection
- **Cross-platform support** - Works on Linux (via /proc) and macOS (via lsof)
- **Graceful fallback** - Navigates to workspace root if terminal is outside the Jupyter workspace

## Installation

Requires JupyterLab 4.6 or later.

```bash
pip install jupyterlab_terminal_show_in_file_browser_extension
```
