Tag v0.62.0 (self-location and winlink resolution)

Release the self-location and winlink-resolution work accumulated since
0.61.0. Pane.from_env() and its Server/Session/Window siblings locate the
object the calling process runs inside; Window.linked_sessions lists every
session that holds a window; point lookups now resolve a linked window to
the session and index tmux itself would act on. Query exceptions
ObjectDoesNotExist and MultipleObjectsReturned now subclass
LibTmuxException, a breaking change for handler ordering.

- CHANGES: date the 0.62.0 release section and open a fresh 0.63.x
  unreleased placeholder
- MIGRATION: release the 0.62.x heading to 0.62.0
- Bump version 0.61.0 -> 0.62.0 in pyproject.toml and __about__.py
- Refresh uv.lock for the new version

Author: tony

CHANGES

@@ -37,14 +37,29 @@ $ uv add libtmux --prerelease allow
 $ uvx --from 'libtmux' --prerelease allow python
 ```
 
-## libtmux 0.62.x (Yet to be released)
+## libtmux 0.63.x (Yet to be released)
 
 <!-- To maintainers and contributors: Please add notes for the forthcoming version below -->
 
 <!-- KEEP THIS PLACEHOLDER - DO NOT REMOVE OR MODIFY THIS LINE -->
 _Notes on the upcoming release will go here._
 <!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
 
+## libtmux 0.62.0 (2026-07-12)
+
+libtmux 0.62.0 teaches libtmux objects to locate themselves and to resolve
+shared windows the way tmux does. Code running *inside* tmux can now find its
+own pane, window, session, and server with
+{meth}`Pane.from_env() <libtmux.Pane.from_env>` and its siblings, and a window
+reports every session that holds it through
+{attr}`~libtmux.Window.linked_sessions`. Point lookups now resolve a linked
+window to the session and index tmux itself would act on rather than an
+arbitrary one. The release also folds {exc}`~libtmux.exc.ObjectDoesNotExist`
+and {exc}`~libtmux.exc.MultipleObjectsReturned` into the
+{exc}`~libtmux.exc.LibTmuxException` hierarchy — a breaking change for
+exception handlers, detailed below. See {ref}`self-location` and
+{ref}`winlinks` for the full story.
+
 ### Breaking changes
 
 #### Query errors join the libtmux exception hierarchy (#718)

MIGRATION

@@ -113,7 +113,7 @@ sections below for detailed migration examples and code samples.
 _Detailed migration steps for the next version will be posted here._
 <!-- END PLACEHOLDER - ADD NEW MIGRATION ENTRIES BELOW THIS LINE -->
 
-## libtmux 0.62.x: Query exceptions join the hierarchy (#718)
+## libtmux 0.62.0: Query exceptions join the hierarchy (#718)
 
 {exc}`~libtmux.exc.ObjectDoesNotExist` and
 {exc}`~libtmux.exc.MultipleObjectsReturned` now subclass

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "libtmux"
-version = "0.61.0"
+version = "0.62.0"
 description = "Typed library that provides an ORM wrapper for tmux, a terminal multiplexer."
 requires-python = ">=3.10,<4.0"
 authors = [

src/libtmux/__about__.py

@@ -4,7 +4,7 @@
 
 __title__ = "libtmux"
 __package_name__ = "libtmux"
-__version__ = "0.61.0"
+__version__ = "0.62.0"
 __description__ = "Typed scripting library / ORM / API wrapper for tmux"
 __email__ = "tony@git-pull.com"
 __author__ = "Tony Narlock"