jupyterlab-claude-code-extension 1.0.16__tar.gz

jupyterlab_claude_code_extension-1.0.16/.claude/CLAUDE.md

@@ -0,0 +1,116 @@
+<!-- @import /home/lab/workspace/.claude/CLAUDE.md -->
+
+# Project-Specific Configuration
+
+This file imports workspace-level configuration from `/home/lab/workspace/.claude/CLAUDE.md`.
+All workspace rules apply. Project-specific rules below strengthen or extend them.
+
+The workspace `/home/lab/workspace/.claude/` directory contains additional instruction files
+referenced by CLAUDE.md. Consult workspace CLAUDE.md and the .claude directory to discover
+all applicable standards.
+
+## Mandatory Bans (Reinforced)
+
+The following workspace rules are STRICTLY ENFORCED for this project:
+
+- **No automatic git tags** - only create tags when user explicitly requests
+- **No automatic version changes** - only modify version in package.json/pyproject.toml/etc. when user explicitly requests
+- **No automatic publishing** - never run `make publish`, `npm publish`, `twine upload`, or similar without explicit user request
+- **No manual package installs if Makefile exists** - use `make install` or equivalent Makefile targets, not direct `pip install`/`uv install`/`npm install`
+- **No automatic git commits or pushes** - only when user explicitly requests
+
+## Project Context
+
+`jupyterlab_claude_code_extension` is a JupyterLab 4 extension that adds a Claude Code session
+management panel to the JupyterLab UI. It exposes recent, all, and favourite Claude Code sessions,
+indicates whether a session is enabled for remote control, allows session removal via context menu,
+and opens Claude Code in a terminal at the session's directory when clicked.
+
+**Technology Stack**:
+
+- TypeScript + Lumino frontend (`src/`) packaged as an `npm` labextension
+- Python `jupyter_server` extension (`jupyterlab_claude_code_extension/`) providing the backend API
+- `hatchling` + `hatch-nodejs-version` + `hatch-jupyter-builder` for build orchestration
+- `jlpm` (JupyterLab's pinned yarn) for JavaScript dependency management
+- `pytest` for server tests, `jest` for frontend unit tests, `Playwright` + Galata for UI integration tests
+
+**Runtime requirements**:
+
+- Python `>= 3.10`
+- JupyterLab `>= 4.0.0`
+- `jupyter_server >= 2.4.0, < 3`
+
+## Required Workspace Skills
+
+The following skills MUST be referenced and applied to relevant work in this project. They live
+under `/home/lab/workspace/.claude/skills/` and are also auto-discovered globally by Claude Code:
+
+- **`jupyterlab-extension`** at `/home/lab/workspace/.claude/skills/jupyterlab-extension/` -
+  JupyterLab extension development guidelines, testing strategy, jupyter-releaser CI/CD workflows,
+  TypeScript compatibility caveats, syntax-highlighting integration, and local development
+  patterns. MUST be consulted for any change to `src/`, `schema/`, `style/`, `package.json`,
+  `pyproject.toml`, `.github/workflows/`, or anything affecting build / install / release flow
+
+- **`playwright`** at `/home/lab/workspace/.claude/skills/playwright/` - Playwright MCP browser
+  automation for inspecting web UIs, serving and viewing local files, testing SVGs/HTML, and
+  connecting to authenticated services like JupyterHub. MUST be used when validating UI changes,
+  capturing README screenshots, reproducing UI bugs, or running ad-hoc visual regression checks
+
+## Makefile Version Pin
+
+The local `Makefile` is sourced from a canonical workspace template:
+
+- Canonical path: `/home/lab/workspace/private/jupyterlab/@utils/jupyterlab-extensions/Makefile`
+- Current pinned version: **1.31** (matches local Makefile as of project initialization)
+
+**MANDATORY**: At the start of any session that touches build, install, release, or CI workflow
+work, check the canonical Makefile's version header (line 1: `# Makefile for Jupyterlab extensions
+version X.YZ`) against the local Makefile's version. If the canonical version is newer, update
+the local Makefile to match before doing any other build-related work, and reflect the new
+version in this section.
+
+Quick check:
+
+```bash
+diff <(head -1 Makefile) <(head -1 /home/lab/workspace/private/jupyterlab/@utils/jupyterlab-extensions/Makefile)
+```
+
+If the headers differ, replace the local Makefile with the canonical one (preserving any
+project-specific targets if they exist - currently there are none).
+
+## Package Manifest Tracking
+
+Both `package.json` AND `package-lock.json` MUST always be committed together:
+
+- `package-lock.json` is **never** added to `.gitignore`
+- The `Makefile` `build` target runs `npx prettier --write package-lock.json package.json` to
+  keep both files formatted - any commit touching dependencies must stage both files
+- When bumping a dependency or running `jlpm install`, always `git add package.json package-lock.json`
+
+## Install Discipline
+
+All package installation in this project MUST go through `make install`:
+
+- `make install` orchestrates the correct sequence: `clean` -> `increment_version` -> `build`
+  (`npm install`, `jlpm install`, `prettier`, `python -m build`) -> `pip install dist/*.whl --force-reinstall`
+- Direct `pip install`, `jlpm install`, `npm install`, `yarn install` are **forbidden** for routine
+  install work in this project - they bypass the version increment, the prettier pass, and the
+  wheel-based reinstall that the Makefile guarantees
+- `make install_dependencies` is the only hook for first-time tooling setup (nodeenv, twine, yarn, rimraf)
+- Run `make help` to see all available targets
+
+## Journal Rules (Project-Specific)
+
+- **APPEND ONLY**: New journal entries MUST be appended at the end of the file, never inserted between existing entries
+- Entries maintain strict chronological order by position - the last entry in the file is always the most recent work
+- Never reorder, move, or insert entries out of sequence
+- The Stellars **journal plugin** is the canonical tool for this file: create via `/journal:create`, append via `/journal:update`, archive via `/journal:archive`. The `journal:journal` skill auto-triggers on any mention of "journal" and runs `journal-tools check` after every write
+- Direct edits to `JOURNAL.md` are a last resort - prefer the plugin so modus secundis format, continuous numbering and append-only order are enforced automatically
+
+## Strengthened Rules
+
+- **No emojis** anywhere in this project (workspace rule strictly enforced - extension UI text, README, code comments, journal entries)
+- **No em-dashes, no arrow symbols** in any markdown - use `-` and `->` per workspace typography rules
+- **`make install` is the only blessed install path** (see Install Discipline above)
+- **Skills `jupyterlab-extension` and `playwright` are mandatory references** for source / UI / CI work (see Required Workspace Skills above)
+- **Makefile version pin** must be re-checked every session touching build flow (see Makefile Version Pin above)

jupyterlab_claude_code_extension-1.0.16/.claude/JOURNAL.md

@@ -0,0 +1,14 @@
+# Claude Code Journal
+
+This journal tracks substantive work on documents, diagrams, and documentation content.
+
+---
+
+1. **Task - Project initialization** (v0.1.0): Bootstrapped `jupyterlab_claude_code_extension` as a new JupyterLab 4 extension with Stellars workspace conventions<br>
+   **Result**: Cookiecutter-scaffolded project (TypeScript `src/`, Python `jupyter_server` extension, `hatchling` + `hatch-jupyter-builder`, Python `>= 3.10`, JupyterLab `>= 4.0.0`) had no git repo, no journal, no badges, and an inline-rules `.claude/CLAUDE.md`. Replaced `.claude/CLAUDE.md` with the canonical `@import` template plus project-specific sections: Mandatory Bans, Project Context, Required Workspace Skills (`jupyterlab-extension`, `playwright`), Makefile Version Pin (canonical at `private/jupyterlab/@utils/jupyterlab-extensions/Makefile`, v1.31), Package Manifest Tracking (`package.json` and `package-lock.json` always committed together), Install Discipline (`make install` only), and Journal Rules. Rewrote `README.md` mirroring `jupyterlab_terminal_show_in_file_browser_extension`: full Stellars badge stack, five-bullet Features section, truncated everything below Uninstall. Verified `.gitignore` keeps `package-lock.json` tracked. Local Makefile byte-identical to canonical v1.31. Repo initialised with `git init -b main` and a single `chore: initial import` commit.
+
+2. **Task - Sessions panel implementation** (v0.1.1): Replaced cookiecutter `hello` stub with the full Claude Code Sessions side panel<br>
+   **Result**: Added `jupyterlab_claude_code_extension/sessions.py` with `list_sessions`, `remote_control_pids`, `toggle_favourite`, `remove_session`. Sessions dedupe to one row per `~/.claude/projects/<encoded>/` (most-recent JSONL by `fileMtime` wins); name comes from Claude's `summary`, falling back to a JSONL `cwd` scan + basename. Remote-control flag scans `~/.claude/sessions/*.json` and confirms each PID via `os.kill(pid, 0)`. Favourites persist atomically to `~/.claude/jupyterlab_claude_code_extension.json`. Tornado handlers in `routes.py` expose `/status`, `/sessions`, `/sessions/favourite`, `/sessions/remove` with traversal protection (15 pytest tests pass). Frontend gates activation on `/status`, adds `src/widget.ts` (Lumino `Widget`, three accordion sections, 10s polling, optimistic favourite toggle, Lumino `Menu`, `terminal:create-new`-driven resume injecting `claude --resume <id>` over stdin), `src/icons.ts` with the Claude logo, `src/types.ts`, `style/base.css`. `make install` registers `v0.1.1 enabled OK`; jest 4/4; live enumeration finds 66 sessions.
+
+3. **Task - Panel UX iteration** (v0.6.15): Hardened naming, terminal reuse, layout, and settings across many follow-up rounds<br>
+   **Result**: Renames now read from `~/.claude/sessions/<pid>.json` `name` field and survive disambiguation by minimum trailing path-segments (frontend); auto-derived names are filtered via two heuristics - same `sessionId` carrying multiple distinct names is volatile, plus a format check (`_looks_auto_named`) flagging 3+ token lowercase-kebab strings. `routes.py` `StatusHandler` now also returns `server_root_dir` so the widget renders relative tooltip paths. Terminal reuse persists `path -> terminalSessionName` in `localStorage` and walks `app.shell.widgets('main')` on click - no duplicate tabs across reloads. JL `ISettingRegistry` plugin (`schema/plugin.json`) exposes `resolveSessionNames` (default true). Other landings: `ILayoutRestorer` registration, scroll-position preservation across the 10s poll, `ContextMenu` class scoping for centered trash icon, JL menu-spec row sizing (24 px / `--jp-ui-font-size1`), body `overflow: hidden` with All-section `flex: 1 1 0`, Material refresh + trash icons mirrored from `jupyterlab_trash_mgmt_extension`, star-as-indicator (no inline button), aboutToClose timing fix so menu commands actually run. 27 pytest pass; jest 4/4; build green at `v0.6.15 enabled OK`.

jupyterlab_claude_code_extension-1.0.16/.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"303ebd38-8ec8-4632-9e31-52eaed07c298","pid":2877,"procStart":"25111612","acquiredAt":1777546738882}

jupyterlab_claude_code_extension-1.0.16/.copier-answers.yml

@@ -0,0 +1,20 @@
+# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
+_commit: v4.5.2
+_src_path: https://github.com/jupyterlab/extension-template
+author_email: konrad.jelen@gmail.com
+author_name: Stellars Henson
+has_ai_rules: false
+has_binder: false
+has_settings: false
+kind: frontend-and-server
+labextension_name: jupyterlab_claude_code_extension
+project_short_description: Jupyterlab extension to help with ai assisted coding with
+    Claude Code. It implements a tool panel (like jupyterlab_trash_mgmt_extension)
+    with recent, all and favourite claude code sessions, it also shows if a session
+    is currently enabled for remote control; It also allows to remove sessions (using
+    context menu); When sesison is clicked - opens claude code in terminal in that
+    folder and continues
+python_name: jupyterlab_claude_code_extension
+repository: ''
+test: true
+

jupyterlab_claude_code_extension-1.0.16/.gitignore

@@ -0,0 +1,131 @@
+*.bundle.*
+lib/
+node_modules/
+*.log
+.eslintcache
+.stylelintcache
+*.egg-info/
+.ipynb_checkpoints
+*.tsbuildinfo
+jupyterlab_claude_code_extension/labextension
+# Version file is handled by hatchling
+jupyterlab_claude_code_extension/_version.py
+
+# Integration tests
+ui-tests/test-results/
+ui-tests/playwright-report/
+
+# Created by https://www.gitignore.io/api/python
+# Edit at https://www.gitignore.io/?templates=python
+
+### Python ###
+# Virtual environments
+.venv
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage/
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# End of https://www.gitignore.io/api/python
+
+# OSX files
+.DS_Store
+
+# Yarn cache
+.yarn/
+
+# pytest artefacts
+junit.xml

jupyterlab_claude_code_extension-1.0.16/.prettierignore

@@ -0,0 +1,6 @@
+node_modules
+**/node_modules
+**/lib
+**/package.json
+!/package.json
+jupyterlab_claude_code_extension

jupyterlab_claude_code_extension-1.0.16/.yarnrc.yml

@@ -0,0 +1,2 @@
+nodeLinker: node-modules
+enableScripts: false

jupyterlab_claude_code_extension-1.0.16/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+<!-- <START NEW CHANGELOG ENTRY> -->
+
+<!-- <END NEW CHANGELOG ENTRY> -->

jupyterlab_claude_code_extension-1.0.16/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Stellars Henson
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

jupyterlab_claude_code_extension-1.0.16/Makefile

@@ -0,0 +1,130 @@
+# Makefile for Jupyterlab extensions version 1.31
+# changelog:
+#   1.31 - mrproper now removes ui-tests/node_modules (Playwright browser binaries)
+#   1.30 - check twine in check_dependencies, ensure publish doesn't fail on missing twine
+#   1.29 - replace yarn with jlpm, add prettier format, auto-commit and push after publish
+#   1.28 - initial versioned Makefile
+# author: Stellars Henson <konrad.jelen@gmail.com>
+# License: MIT Open Source License
+
+.PHONY: build install clean uninstall publish dependencies mrproper increment_version install_dependencies check_dependencies upgrade help test
+.DEFAULT_GOAL := help
+
+# Read current version from package.json (only if node is available)
+VERSION := $(shell command -v node >/dev/null 2>&1 && node -p "require('./package.json').version" || echo "0.0.0")
+
+## increment project version
+increment_version:
+	@echo "Current version: $(VERSION)"
+	@bash -c 'CURRENT_VERSION=$(VERSION); \
+	IFS="." read -r major minor patch <<< "$$CURRENT_VERSION"; \
+	NEW_PATCH=$$((patch + 1)); \
+	NEW_VERSION="$$major.$$minor.$$NEW_PATCH"; \
+	echo "New version: $$NEW_VERSION"; \
+	sed -i "s/\"version\": \"$$CURRENT_VERSION\"/\"version\": \"$$NEW_VERSION\"/" package.json; '
+
+## build packages
+build: clean increment_version check_dependencies
+	npm install
+	jlpm install
+	npx prettier --write package-lock.json package.json
+	python -m build
+
+## install package
+install: build
+	pip install dist/*.whl --force-reinstall
+
+## run tests
+test: check_dependencies
+	jlpm test
+
+## clean builds and installables
+clean: uninstall  check_dependencies
+	@command -v npm >/dev/null 2>&1 && npm run clean || true
+	@command -v npm >/dev/null 2>&1 && npm run clean:labextension || true
+	rm -rf dist lib || true
+
+## uninstall package
+uninstall:  check_dependencies
+	pip uninstall -y dist/*.whl 2>/dev/null || true
+
+## check if required dependencies are installed
+check_dependencies:
+	@echo "Checking dependencies..."
+	@MISSING=""; \
+	command -v node >/dev/null 2>&1 || MISSING="$$MISSING node"; \
+	command -v npm >/dev/null 2>&1 || MISSING="$$MISSING npm"; \
+	python -m twine --version >/dev/null 2>&1 || MISSING="$$MISSING twine"; \
+	if [ -n "$$MISSING" ]; then \
+		echo "Missing dependencies:$$MISSING"; \
+		echo "Installing missing dependencies..."; \
+		$(MAKE) install_dependencies; \
+	else \
+		echo "All dependencies are installed."; \
+	fi
+
+## publish package to public repository
+publish: check_dependencies install
+	npm publish --access public
+	python -m twine upload dist/*
+	git add package.json package-lock.json
+	git commit -m "chore: post-publish $$(node -p "require('./package.json').version") package metadata"
+	git push
+
+## install all required build dependencies
+install_dependencies:
+	pip install nodeenv twine
+	nodeenv --node=lts --prebuilt -p
+	npm install -g yarn rimraf
+
+## upgrade all npm and yarn dependencies
+upgrade: check_dependencies
+	jlpm up
+
+## cleanup all build and metabuild artefacts
+mrproper: clean uninstall
+	rm -rf node_modules .yarn ui-tests/node_modules || true
+
+## prints the list of available commands
+help:
+	@echo ""
+	@echo "$$(tput bold)Available rules:$$(tput sgr0)"
+	@sed -n -e "/^## / { \
+		h; \
+		s/.*//; \
+		:doc" \
+		-e "H; \
+		n; \
+		s/^## //; \
+		t doc" \
+		-e "s/:.*//; \
+		G; \
+		s/\\n## /---/; \
+		s/\\n/ /g; \
+		p; \
+	}" ${MAKEFILE_LIST} \
+	| LC_ALL='C' sort --ignore-case \
+	| awk -F '---' \
+		-v ncol=$$(tput cols) \
+		-v indent=19 \
+		-v col_on="$$(tput setaf 6)" \
+		-v col_off="$$(tput sgr0)" \
+	'{ \
+		printf "%s%*s%s ", col_on, -indent, $$1, col_off; \
+		n = split($$2, words, " "); \
+		line_length = ncol - indent; \
+		for (i = 1; i <= n; i++) { \
+			line_length -= length(words[i]) + 1; \
+			if (line_length <= 0) { \
+				line_length = ncol - indent - length(words[i]) - 1; \
+				printf "\n%*s ", -indent, " "; \
+			} \
+			printf "%s ", words[i]; \
+		} \
+		printf "\n"; \
+	}' 
+	@echo ""
+
+
+# EOF
+

jupyterlab_claude_code_extension-1.0.16/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: jupyterlab_claude_code_extension
+Version: 1.0.16
+Summary: Browse, resume, and manage your Claude Code CLI sessions from a JupyterLab side panel. One click reactivates the right terminal - no duplicate tabs, live remote-control indicator, and favourites for the projects you keep coming back to.
+Project-URL: Homepage, https://github.com/stellarshenson/jupyterlab_claude_code_extension
+Project-URL: Bug Tracker, https://github.com/stellarshenson/jupyterlab_claude_code_extension/issues
+Project-URL: Repository, https://github.com/stellarshenson/jupyterlab_claude_code_extension.git
+Author-email: Stellars Henson <konrad.jelen@gmail.com>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2026, Stellars Henson
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+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: License :: OSI Approved :: BSD License
+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
+Requires-Dist: jupyter-server<3,>=2.4.0
+Provides-Extra: dev
+Requires-Dist: jupyterlab>=4; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: coverage; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-asyncio; extra == 'test'
+Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: pytest-jupyter[server]>=0.6.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# jupyterlab_claude_code_extension
+
+[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_claude_code_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_claude_code_extension/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/jupyterlab_claude_code_extension.svg)](https://www.npmjs.com/package/jupyterlab_claude_code_extension)
+[![PyPI version](https://img.shields.io/pypi/v/jupyterlab_claude_code_extension.svg)](https://pypi.org/project/jupyterlab_claude_code_extension/)
+[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab_claude_code_extension)](https://pepy.tech/project/jupyterlab_claude_code_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)
+[![Donate PayPal](https://img.shields.io/badge/Donate-PayPal-blue?style=flat)](https://www.paypal.com/donate/?hosted_button_id=B4KPBJDLLXTSA)
+
+Manage Claude Code CLI sessions from inside JupyterLab. A left-sidebar panel lists every project under `~/.claude/projects/` deduplicated to one row per folder, marks live remote-control sessions with a green dot, and lets you jump back into any session by opening (or reactivating) a terminal pwd'd to that project and auto-running `claude --resume <id>`.
+
+![Claude Code Sessions panel](.resources/screenshot.png)
+
+## Features
+
+- **Three-section side panel** - Favourites, Recent (top 10 by activity), and All. Each section scrolls independently; Favourites disappears when empty
+- **Live remote-control indicator** - green dot on rows whose `~/.claude/sessions/<pid>.json` is alive (verified via `os.kill(pid, 0)`)
+- **One-click resume** - click a row to find an existing terminal pwd'd to that project (queried server-side from the pty's process tree) and reactivate its tab; only spawns a fresh terminal if none matches. Concurrent rapid clicks are coalesced
+- **Smart name resolution** - shows the user-set `/rename` name when available; auto-detected names (volatile across the same `sessionId` or 3+ token lowercase-kebab) fall back to the folder basename. Toggle the behaviour via the `resolveSessionNames` setting
+- **Path-segment disambiguation** - when two sessions share the same display name, the row reveals the minimum number of trailing path segments needed for each to be unique
+- **Favourites** - star a session via the right-click menu; persisted server-side at `~/.claude/jupyterlab_claude_code_extension.json`
+- **Layout restorer** - panel visibility persists across JupyterLab reloads
+- **Auto-disabled** when the `claude` binary is not on `PATH`
+- **Hover tooltip** with relative path (vs JL root), last activity, message count, branch, first prompt, session id
+
+## Requirements
+
+- JupyterLab >= 4.0.0
+- Python >= 3.10
+- `claude` CLI on `PATH`
+
+## Install
+
+Developers must install via the project `Makefile` (which orchestrates clean, build, and pip install of the resulting wheel):
+
+```bash
+make install
+```
+
+End-users can install the published package from PyPI:
+
+```bash
+pip install jupyterlab_claude_code_extension
+```
+
+## Uninstall
+
+```bash
+pip uninstall jupyterlab_claude_code_extension
+```

jupyterlab_claude_code_extension-1.0.16/README.md

@@ -0,0 +1,51 @@
+# jupyterlab_claude_code_extension
+
+[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_claude_code_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_claude_code_extension/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/jupyterlab_claude_code_extension.svg)](https://www.npmjs.com/package/jupyterlab_claude_code_extension)
+[![PyPI version](https://img.shields.io/pypi/v/jupyterlab_claude_code_extension.svg)](https://pypi.org/project/jupyterlab_claude_code_extension/)
+[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab_claude_code_extension)](https://pepy.tech/project/jupyterlab_claude_code_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)
+[![Donate PayPal](https://img.shields.io/badge/Donate-PayPal-blue?style=flat)](https://www.paypal.com/donate/?hosted_button_id=B4KPBJDLLXTSA)
+
+Manage Claude Code CLI sessions from inside JupyterLab. A left-sidebar panel lists every project under `~/.claude/projects/` deduplicated to one row per folder, marks live remote-control sessions with a green dot, and lets you jump back into any session by opening (or reactivating) a terminal pwd'd to that project and auto-running `claude --resume <id>`.
+
+![Claude Code Sessions panel](.resources/screenshot.png)
+
+## Features
+
+- **Three-section side panel** - Favourites, Recent (top 10 by activity), and All. Each section scrolls independently; Favourites disappears when empty
+- **Live remote-control indicator** - green dot on rows whose `~/.claude/sessions/<pid>.json` is alive (verified via `os.kill(pid, 0)`)
+- **One-click resume** - click a row to find an existing terminal pwd'd to that project (queried server-side from the pty's process tree) and reactivate its tab; only spawns a fresh terminal if none matches. Concurrent rapid clicks are coalesced
+- **Smart name resolution** - shows the user-set `/rename` name when available; auto-detected names (volatile across the same `sessionId` or 3+ token lowercase-kebab) fall back to the folder basename. Toggle the behaviour via the `resolveSessionNames` setting
+- **Path-segment disambiguation** - when two sessions share the same display name, the row reveals the minimum number of trailing path segments needed for each to be unique
+- **Favourites** - star a session via the right-click menu; persisted server-side at `~/.claude/jupyterlab_claude_code_extension.json`
+- **Layout restorer** - panel visibility persists across JupyterLab reloads
+- **Auto-disabled** when the `claude` binary is not on `PATH`
+- **Hover tooltip** with relative path (vs JL root), last activity, message count, branch, first prompt, session id
+
+## Requirements
+
+- JupyterLab >= 4.0.0
+- Python >= 3.10
+- `claude` CLI on `PATH`
+
+## Install
+
+Developers must install via the project `Makefile` (which orchestrates clean, build, and pip install of the resulting wheel):
+
+```bash
+make install
+```
+
+End-users can install the published package from PyPI:
+
+```bash
+pip install jupyterlab_claude_code_extension
+```
+
+## Uninstall
+
+```bash
+pip uninstall jupyterlab_claude_code_extension
+```