Tag v0.0.1-alpha.4

why: libtmux-mcp stops being a demonstration of the filter language and
becomes a server an agent can be pointed at: it can wait for a command
and report how it ended, bound what it reads, refuse what an operator
withheld, and tell a client when tmux changed rather than being asked.
ControlClient gains the events that last part rests on.

what:
- Add the MCP surface and the control-mode events to the changelog
- Move gradle.properties to the next development version
- Move 16 install coordinates, and one in the BOM's prose that had been
  left a release behind

Author: tony

CHANGELOG.md

@@ -12,6 +12,8 @@ exact version rather than a range.
 
 ## Unreleased
 
+## 0.0.1-alpha.4 — 2026-08-16
+
 ### Added
 
 - **`libtmux-mcp` can wait, so an agent does not have to poll.** `tmux_run`

README.md

@@ -253,7 +253,7 @@ against each other.
 <!-- snippet: skip: build configuration, not library code -->
 ```kotlin
 dependencies {
-    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.3"))
+    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.4"))
 
     implementation("io.github.libtmux:libtmux")
     testImplementation("io.github.libtmux:libtmux-junit5")
@@ -269,7 +269,7 @@ dependencies {
     <dependency>
       <groupId>io.github.libtmux</groupId>
       <artifactId>libtmux-bom</artifactId>
-      <version>0.0.1-alpha.3</version>
+      <version>0.0.1-alpha.4</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>

docs/guide/kotlin.md

@@ -38,7 +38,7 @@ than a `Predicate`, so passing a `FilterExpr` to it does not compile. That is wh
 
 <!-- snippet: skip: build configuration, not library code -->
 ```kotlin
-implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.3"))
+implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.4"))
 implementation("io.github.libtmux:libtmux-kotlin")
 ```
 

docs/guide/scala.md

@@ -8,7 +8,7 @@ Depend on it with a single `%`, never `%%`:
 
 <!-- snippet: skip: build configuration, not library code -->
 ```scala
-libraryDependencies += "io.github.libtmux" % "libtmux" % "0.0.1-alpha.3"
+libraryDependencies += "io.github.libtmux" % "libtmux" % "0.0.1-alpha.4"
 ```
 
 `%%` would ask for `libtmux_3`, which does not exist and should not. A Java

gradle.properties

@@ -8,7 +8,7 @@
 # Trailing -SNAPSHOT because this is the development value, and a snapshot sorts below
 # the release it precedes. A release overrides this with -PlibtmuxVersion, which is why
 # it is a property and not a literal in the convention plugin. See RELEASING.md.
-libtmuxVersion=0.0.1-alpha.3-SNAPSHOT
+libtmuxVersion=0.0.1-alpha.4-SNAPSHOT
 
 # The build cache makes an unchanged module's compilation and its tests free on a second run, which
 # is most of what a five-module build spends its time on.

libtmux-bom/README.md

@@ -5,7 +5,7 @@
 <!-- snippet: skip: build configuration, not library code -->
 ```kotlin
 dependencies {
-    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.3"))
+    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.4"))
 
     implementation("io.github.libtmux:libtmux")            // no version
     implementation("io.github.libtmux:libtmux-jackson")    // no version
@@ -22,7 +22,7 @@ dependencies {
     <dependency>
       <groupId>io.github.libtmux</groupId>
       <artifactId>libtmux-bom</artifactId>
-      <version>0.0.1-alpha.3</version>
+      <version>0.0.1-alpha.4</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -49,12 +49,12 @@ $ ./gradlew dependencies --configuration runtimeClasspath
 
 ```text
 runtimeClasspath
-+--- io.github.libtmux:libtmux-bom:0.0.1-alpha.3
-|    \--- io.github.libtmux:libtmux:0.0.1-alpha.3 (c)
-\--- io.github.libtmux:libtmux -> 0.0.1-alpha.3
++--- io.github.libtmux:libtmux-bom:0.0.1-alpha.4
+|    \--- io.github.libtmux:libtmux:0.0.1-alpha.4 (c)
+\--- io.github.libtmux:libtmux -> 0.0.1-alpha.4
 ```
 
-The `-> 0.0.1-alpha.2` on a coordinate you wrote without a version is the platform
+The `-> 0.0.1-alpha.4` on a coordinate you wrote without a version is the platform
 doing its job.
 
 ## What it manages

libtmux-jackson/README.md

@@ -16,7 +16,7 @@ not a Java program.
 <!-- snippet: skip: build configuration, not library code -->
 ```kotlin
 dependencies {
-    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.3"))
+    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.4"))
     implementation("io.github.libtmux:libtmux-jackson")
 }
 ```

libtmux-junit5/README.md

@@ -14,7 +14,7 @@ For testing *your* code against real tmux — not for testing libtmux.
 <!-- snippet: skip: build configuration, not library code -->
 ```kotlin
 dependencies {
-    testImplementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.3"))
+    testImplementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.4"))
     testImplementation("io.github.libtmux:libtmux-junit5")
 }
 ```

libtmux-kotlin/README.md

@@ -43,7 +43,7 @@ operator did not compile until its type parameter was bounded `T : Any`, because
 <!-- snippet: skip: build configuration, not library code -->
 ```kotlin
 dependencies {
-    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.3"))
+    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.4"))
     implementation("io.github.libtmux:libtmux-kotlin")
 }
 ```

libtmux-mcp/README.md

@@ -315,7 +315,7 @@ it attach a control client and push notifications as tmux changes.
 <!-- snippet: skip: build configuration, not library code -->
 ```kotlin
 dependencies {
-    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.3"))
+    implementation(platform("io.github.libtmux:libtmux-bom:0.0.1-alpha.4"))
     implementation("io.github.libtmux:libtmux-mcp")
 }
 ```