Add worktree picker mode

.github/workflows/release.yml

@@ -0,0 +1,67 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  create-release:
+    name: Create Release
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Create GitHub release
+        uses: taiki-e/create-gh-release-action@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+  upload-binaries:
+    name: Build ${{ matrix.target }}
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: create-release
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-musl
+            build-tool: cargo-zigbuild
+          - os: macos-26
+            target: aarch64-apple-darwin
+            build-tool: cargo
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            build-tool: cargo
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: 1.90
+          targets: ${{ matrix.target }}
+
+      - name: Upload release archive
+        uses: taiki-e/upload-rust-binary-action@v1
+        with:
+          bin: wisp
+          package: wisp
+          manifest-path: crates/wisp-bin/Cargo.toml
+          target: ${{ matrix.target }}
+          archive: wisp-$target
+          build-tool: ${{ matrix.build-tool }}
+          include: README.md LICENSE
+          checksum: sha256
+          token: ${{ secrets.GITHUB_TOKEN }}

AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-Wisp is a Rust 2024 tmux navigation workspace built around one canonical session model in `wisp-core`, thin integration adapters (`wisp-tmux`, `wisp-zoxide`, `wisp-preview`), and multiple projections/renderers (`wisp-ui`, `wisp-status`, `wisp-bin`). Keep logic in the lowest pure crate that can own it.
+Wisp is a Rust 2024 tmux navigation workspace built around one canonical session model in `wisp-core`, thin integration adapters (`wisp-tmux`, `wisp-zoxide`, `wisp-preview`), and multiple projections/renderers (`wisp-ui`, `wisp-status`, `wisp`). Keep logic in the lowest pure crate that can own it.
 
 ## Testing expectations
 
@@ -9,7 +9,7 @@ Wisp is a Rust 2024 tmux navigation workspace built around one canonical session
   - `cargo clippy --workspace --all-targets --all-features -- -D warnings`
   - `cargo test --workspace --all-targets`
 - If you touch tmux integration, run the real isolated-socket tests in `crates/wisp-tmux/tests/integration.rs`.
-- If you touch CLI behavior, run `cargo test -p wisp-bin --test smoke`.
+- If you touch CLI behavior, run `cargo test -p wisp --test smoke`.
 - If you touch hot-path projections or status formatting, make sure the benches still compile.
 
 ## Performance expectations

Cargo.toml

@@ -17,6 +17,7 @@ version = "0.1.0"
 edition = "2024"
 rust-version = "1.90"
 license = "MIT"
+repository = "https://github.com/Pajn/wisp"
 publish = false
 
 [workspace.lints.rust]
@@ -38,3 +39,12 @@ serde = { version = "1", features = ["derive"] }
 serde_ignored = "0.1"
 thiserror = "2"
 toml = "0.8"
+wisp-app = { version = "0.1.0", path = "crates/wisp-app" }
+wisp-config = { version = "0.1.0", path = "crates/wisp-config" }
+wisp-core = { version = "0.1.0", path = "crates/wisp-core" }
+wisp-fuzzy = { version = "0.1.0", path = "crates/wisp-fuzzy" }
+wisp-preview = { version = "0.1.0", path = "crates/wisp-preview" }
+wisp-status = { version = "0.1.0", path = "crates/wisp-status" }
+wisp-tmux = { version = "0.1.0", path = "crates/wisp-tmux" }
+wisp-ui = { version = "0.1.0", path = "crates/wisp-ui" }
+wisp-zoxide = { version = "0.1.0", path = "crates/wisp-zoxide" }

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -6,6 +6,7 @@ Wisp is a native Rust tmux navigation tool inspired by `tmux-sessionx`. It share
 
 - tmux-aware session discovery, switching, and attachment
 - sidebar pane and sidebar popup surfaces in addition to the main picker
+- git worktree-aware picker: see only sessions for the current repo, or browse all worktrees
 - zoxide-backed directory discovery
 - fuzzy filtering and session previews
 - configurable behavior through TOML config plus environment overrides
@@ -22,7 +23,7 @@ Wisp is a native Rust tmux navigation tool inspired by `tmux-sessionx`. It share
 - `wisp-ui`: shared ratatui renderers and key translation
 - `wisp-status`: status-line formatting and dedup logic
 - `wisp-app`: app-facing state assembly helpers
-- `wisp-bin`: CLI entrypoint and runtime wiring
+- `wisp`: CLI entrypoint and runtime wiring
 
 ## Quick start
 
@@ -38,23 +39,39 @@ Install the CLI:
 cargo install --git https://github.com/Pajn/wisp.git --bin wisp
 ```
 
+Install the latest tagged binary with `cargo-binstall`:
+
+```bash
+cargo binstall --git https://github.com/Pajn/wisp.git wisp
+```
+
 If you want a specific revision while the project is evolving, pin a branch, tag, or commit:
 
 ```bash
 cargo install --git https://github.com/Pajn/wisp.git --bin wisp --branch main
 ```
 
+For a specific tagged release with `cargo-binstall`, pin the tag:
+
+```bash
+cargo binstall --git https://github.com/Pajn/wisp.git wisp --tag v0.1.0
+```
+
 Common commands after install:
 
 ```bash
 wisp doctor
 wisp popup
+wisp popup --worktree
 wisp fullscreen
+wisp fullscreen --worktree
 wisp sidebar-popup
 wisp sidebar-pane
 wisp statusline install
 ```
 
+Use `--worktree` (or `-w`) to start the picker in worktree mode, which shows only sessions belonging to worktrees of the current repo alongside worktrees that don't yet have sessions.
+
 Example tmux binding:
 
 Add this to `~/.tmux.conf` to open Wisp with `prefix + o`:
@@ -106,7 +123,7 @@ Config file discovery:
 cargo fmt --check
 cargo clippy --workspace --all-targets --all-features -- -D warnings
 cargo test --workspace --all-targets
-cargo test -p wisp-bin --test smoke
+cargo test -p wisp --test smoke
 cargo bench -p wisp-core --bench projections --no-run
 cargo bench -p wisp-status --bench formatting --no-run
 ```

crates/wisp-app/Cargo.toml

@@ -1,13 +1,17 @@
 [package]
 name = "wisp-app"
-version = "0.1.0"
-edition = "2024"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+description = "application state assembly for Wisp"
 
 [dependencies]
-wisp-config = { path = "../wisp-config" }
-wisp-core = { path = "../wisp-core" }
-wisp-tmux = { path = "../wisp-tmux" }
-wisp-zoxide = { path = "../wisp-zoxide" }
+wisp-config.workspace = true
+wisp-core.workspace = true
+wisp-tmux.workspace = true
+wisp-zoxide.workspace = true
 
 [lints]
 workspace = true

crates/wisp-bin/Cargo.toml

@@ -1,25 +1,38 @@
 [package]
-name = "wisp-bin"
-version = "0.1.0"
-edition = "2024"
+name = "wisp"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+description = "tmux-aware workspace navigator and status UI"
 
 [[bin]]
 name = "wisp"
 path = "src/main.rs"
 
+[package.metadata.binstall]
+pkg-url = "{ repo }/releases/download/v{ version }/{ bin }-{ target }.{ archive-format }"
+pkg-fmt = "tar.gz"
+bin-dir = "{ bin }{ binary-ext }"
+
+[package.metadata.binstall.overrides.x86_64-pc-windows-msvc]
+pkg-fmt = "zip"
+bin-dir = "{ bin }.exe"
+
 [dependencies]
 argh = "0.1"
 crossterm.workspace = true
 ratatui.workspace = true
-wisp-app = { path = "../wisp-app" }
-wisp-config = { path = "../wisp-config" }
-wisp-core = { path = "../wisp-core" }
-wisp-fuzzy = { path = "../wisp-fuzzy" }
-wisp-preview = { path = "../wisp-preview" }
-wisp-status = { path = "../wisp-status" }
-wisp-tmux = { path = "../wisp-tmux" }
-wisp-ui = { path = "../wisp-ui" }
-wisp-zoxide = { path = "../wisp-zoxide" }
+wisp-app.workspace = true
+wisp-config.workspace = true
+wisp-core.workspace = true
+wisp-fuzzy.workspace = true
+wisp-preview.workspace = true
+wisp-status.workspace = true
+wisp-tmux.workspace = true
+wisp-ui.workspace = true
+wisp-zoxide.workspace = true
 
 [lints]
 workspace = true