peekme 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.2.3 (2026-09-28)
+
+- Option+P works on a Mac also over SSH and inside tmux. 0.2.2 found out from the environment
+  that the keyboard is a Mac's, and over SSH or in tmux it could not. Now `π` explains whenever
+  something is selected, and is typed as usual when nothing is.
+- Alt+P arrives correctly when tmux sends keys in its extended format (`extended-keys`).
+- Selecting only empty space no longer opens a box.
+
+## 0.2.2 (2026-09-28)
+
+- Option+P works on a Mac as it is. Mac terminals send Option+P as `π`, and peekme now takes
+  that as the shortcut, like Claude Code does. Before, you had to set Option to act as Meta in
+  the terminal. Also over SSH from Terminal or iTerm2.
+- On macOS peekme finds the running Claude Code session exactly. Before, it took the newest
+  session in the directory, which is wrong when two run there.
+
 ## 0.2.1 (2026-09-28)
 
 - You don't need Rust any more. peekme can be installed with npm (`npm i -g peekme`), with

package/README.md

@@ -1,7 +1,7 @@
 # peekme
 
 Peek me. Pick me. Select text in [Codex CLI](https://github.com/openai/codex) or
-[Claude Code](https://github.com/anthropics/claude-code) output, press **Alt+P**, and a short
+[Claude Code](https://github.com/anthropics/claude-code) output, press **Alt+P** (**Option+P** on a Mac), and a short
 explanation opens right next to that text, inside the terminal. The other lines move to make
 room, like Peek in VS Code. Esc closes it and the screen is exactly as before.
 
@@ -10,7 +10,7 @@ room, like Peek in VS Code. Esc closes it and the screen is exactly as before.
 The explanation comes from a small, fast model and it knows the conversation. If you select
 "its split panes" in an answer that recommends Kitty, it tells you it is about Kitty.
 
-Status: 0.2.1. Tested on Linux with X11 and bash, with Codex 0.157 and Claude Code 2.1.283.
+Status: 0.2.3. Tested on Linux with X11 and bash, with Codex 0.157 and Claude Code 2.1.283.
 
 ## Install
 
@@ -24,6 +24,9 @@ cargo install peekme                          # builds it with Rust
 peekme install
 ```
 
+npm 12 may say that it skipped an install script of peekme. That is fine: peekme then downloads
+its binary the first time it runs.
+
 Without npm, Homebrew or Rust, the script from the
 [latest release](https://github.com/GregoryBolshakov/peekme/releases/latest) puts peekme in
 `~/.local/bin`:
@@ -58,13 +61,25 @@ Alt+P. When the agent draws full screen (Codex since 0.157, Claude Code with
 
 | Key | When | What it does |
 |---|---|---|
-| Alt+P | any time | explain the selected text |
+| Alt+P (Mac: Option+P) | any time | explain the selected text |
 | Alt+P again | box is open, same selection | explain again using the whole conversation |
 | PgUp / PgDn, mouse wheel | box is open | scroll a long explanation |
 | Esc | box is open | close the box |
 | typing | box is open | goes to the agent's input line, the box stays open |
 | Enter | box is open | sends your message and closes the box |
 
+### On a Mac
+
+Option+P works as it is, with no terminal setting, also over SSH and inside tmux. A Mac
+terminal sends Option+P as the character `π`. When something is selected, peekme takes `π` as
+the shortcut. When nothing is selected, `π` is typed as usual, so you never lose the letter. If
+you type Greek, `π` stays a letter. If your terminal sends Option as Meta, Option+P works too.
+
+When the agent draws full screen, peekme gets the selection from the agent. Otherwise (Claude
+Code's classic screen) it reads the clipboard: iTerm2 copies a selection there by itself, in
+Terminal press Cmd+C after you select. Over SSH only the agent's own selection can be read, so
+use the full screen mode there (Codex uses it by default, Claude Code with `"tui": "fullscreen"`).
+
 In Claude Code, Alt+P opens the model picker. With peekme it explains the selection instead.
 `/model` still opens the model picker.
 
@@ -163,7 +178,7 @@ To use peekme with another program, run `peekme -- COMMAND`.
 - In full screen mode selection works anywhere, also over SSH, because peekme reads the
   selection from the agent. Otherwise peekme needs the terminal's selection, which it reads on
   Linux with X11 only. On Wayland it works through XWayland, and on macOS it reads the
-  clipboard, not tested.
+  clipboard (see [On a Mac](#on-a-mac)).
 - Claude Code full screen: if `copyOnSelect` is off, Claude does not report the selection. Then
   only a Shift+drag selection works (read from X11 PRIMARY).
 - An explanation takes about 1 to 2 seconds to start arriving.

package/npm-shrinkwrap.json

@@ -19,7 +19,7 @@
       "hasInstallScript": true,
       "license": "MIT OR Apache-2.0",
       "name": "peekme",
-      "version": "0.2.1"
+      "version": "0.2.3"
     },
     "node_modules/detect-libc": {
       "engines": {
@@ -48,5 +48,5 @@
     }
   },
   "requires": true,
-  "version": "0.2.1"
+  "version": "0.2.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "artifactDownloadUrls": [
-    "https://github.com/GregoryBolshakov/peekme/releases/download/v0.2.1"
+    "https://github.com/GregoryBolshakov/peekme/releases/download/v0.2.3"
   ],
   "author": "Gregory Bolshakov",
   "bin": {
@@ -69,7 +69,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "0.2.1",
+  "version": "0.2.3",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"