rex-worktrees 0.4.5 → 0.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Rex Worktrees
2
2
 
3
- A keyboard-driven [Rex](https://www.superlogical.com/rex/docs) plugin for opening and creating **Git worktrees** and **Jujutsu (JJ) workspaces**. Pick a project, machine, checkout, and session; it opens a shell there. No agent or model required.
3
+ A keyboard-driven [Rex](https://www.superlogical.com/rex/docs) plugin for opening and creating **Git worktrees** and **Jujutsu (JJ) workspaces**. Pick a project, machine, session, and worktree; it opens a shell there. No agent or model required.
4
4
 
5
5
  <img width="693" height="236" alt="image" src="https://github.com/user-attachments/assets/fadd8e3c-30fc-4f94-98ca-41132a23ff36" />
6
6
 
@@ -34,25 +34,34 @@ Open **Open Worktree…** from the Rex palette, or run:
34
34
  rex do worktrees_open
35
35
  ```
36
36
 
37
+ The popup detects the source terminal's project, current worktree, branch or revision, and full directory path. Git worktrees are separate checkout directories sharing one repository—not separate repositories or branch names.
38
+
37
39
  1. **Project:** select a discovered project or type an absolute repository path.
38
40
  2. **Machine:** choose this machine or an existing Rex host.
39
- 3. **Checkout / Workspace:** select an existing checkout, or type a new Git branch or JJ workspace name. New JJ workspaces also need a **Start from** revision; a valid `trunk()` is selected automatically.
40
- 4. **Session:** select an existing session, or type a name to create one.
41
- 5. Choose **Open / Create / Clone** or press **Ctrl+S** from the form.
41
+ 3. **Session:** select an existing session, or type a name to create one.
42
+ 4. **Worktree / Workspace:** select an existing one, or choose **Create new worktree… / Create new workspace…**. This list contains worktrees, not branches or clone actions.
43
+ 5. **Branch:** **Create new worktree…** opens the branch editor directly, without another click on the form. Select an unused existing branch or type a new branch name. JJ uses **Start from** instead; a valid `trunk()` is selected automatically.
44
+ 6. **Directory:** new worktrees get a proposed absolute path; change it only if needed. A new JJ workspace takes its name from the directory's final component.
45
+ 7. Choose **Open worktree / Create worktree & open**, or press **Ctrl+S** from the form. Accepting a field only updates the form; creation happens on submission.
46
+
47
+ **Mode** reuses a matching tab by default; choose a new tab or split instead.
42
48
 
43
- **Mode** reuses a matching tab by default; choose a new tab or split instead. New Git checkouts can have a custom **Directory** name, separate from the branch.
49
+ For an **existing worktree**, Branch (or Revision) and Directory describe the detected checkout. They remain readable and **read-only—not disabled**; Tab skips them. Select a different worktree to open another checkout. For a **new worktree**, Branch and Directory are editable.
44
50
 
45
- The underlined `REX / WORKTREES` header and fields keep fixed positions; unavailable fields stay disabled. Editors and messages reuse the same details area, so only choice lists and long details scroll.
51
+ The underlined `REX / WORKTREES` header, fields, and footer keep fixed positions. Editors and messages reuse the same details area, so only choice lists and long details scroll.
46
52
 
47
53
  Shells and interactive Git/JJ clones stay attached to the destination terminal. The shell comes from `$SHELL`, falling back to `/bin/sh`.
48
54
 
55
+ Rex owns terminal placement, focus, and popup cleanup. New sessions and their first terminal are created together; checkout/clone work then runs in that terminal independently of the chooser.
56
+ Connection and review snapshots are operation-local: new sessions and forced new tabs skip reuse scans, and submission still checks fresh host and checkout state.
57
+
49
58
  | Key | Action |
50
59
  | --- | --- |
51
60
  | Tab / Shift+Tab | Move between fields and buttons |
52
61
  | ↑ / ↓ | Navigate fields or choices |
53
62
  | Enter | Edit a field, accept its value, or activate a focused button |
54
63
  | Ctrl+S | Submit the form; inside an editor, only accept that field |
55
- | Esc | Leave the editor, or close the form |
64
+ | Esc | Return from an editor to the form; from the form, close the popup |
56
65
  | PageUp / PageDown | Scroll long details |
57
66
 
58
67
  Optional shortcut—add outside the managed section of your Rex config, then reload:
@@ -76,13 +85,13 @@ Both settings are optional. `projects` lists repositories explicitly; `roots` di
76
85
 
77
86
  ### Other machines
78
87
 
79
- Install and run setup on each execution machine, with matching plugin versions and local Git/JJ tools. Connect the host through Rex first. Paths and configuration belong to the selected machine.
88
+ Install and run setup on each execution machine, with matching plugin versions and local Git/JJ tools. Connect the host through Rex first. Paths and configuration belong to the selected machine. This native-integration update uses helper protocol v5; update all execution machines together.
80
89
 
81
- The chooser can clone a known project to another directory or host. Only pushed history transfers—not uncommitted work, unpublished changes, or credentials. Cross-host execution and cloning are experimental; live remote Linux destinations have not been verified.
90
+ If the selected machine lacks the project, the form proposes cloning it and shows the repository destination explicitly. **Directory** edits that path, and submission becomes **Clone & open**. Changing a field never starts a clone. The Worktree picker can also create a separate worktree after cloning; Directory then controls that worktree's path. Cloning opens a new tab. Only pushed history transfers—not uncommitted work, unpublished changes, or credentials. Cross-host execution and cloning are experimental; live remote Linux destinations have not been verified.
82
91
 
83
92
  ## Safety
84
93
 
85
- - Existing checkouts open unchanged. The plugin does not switch, reset, stash, clean, or delete your work.
94
+ - Existing checkouts open unchanged. The plugin never switches, resets, stashes, cleans, or deletes an existing checkout.
86
95
  - **Creating a JJ workspace runs `jj workspace add`, which may snapshot its source workspace.**
87
96
  - Closing the chooser or a tab does not delete a checkout or stop an already-submitted task.
88
97
  - If a launch times out or says **needs inspection**, inspect the destination and session before retrying; a task may already exist.
@@ -1,4 +1,4 @@
1
1
  [diffend] Oversized file quarantined before diffing.
2
2
  name: package/dist/rex-worktrees
3
3
  size: 64491792 bytes
4
- sha256: 5a846578510c7d9cb4cba959a7bdaf9733ab236baae0cf7467c4a94c98916aea
4
+ sha256: c6bff9f6e9f3ba2fb81f60d456750c962d35023c9d7257d491e8f351c2546b08