Cursor SSH remote integration for workmux worktrees (#8060)
Add wm-cursor (wmc) script that bridges workmux with Cursor SSH remote, giving each worktree its own Cursor window with an independently-focused grouped tmux session. Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
hugocasa
@@ -172,6 +172,61 @@ The setup is defined in `.workmux.yaml` at the repo root. Key sections:
|
||||
- **`files.copy`**: Copies `backend/.env` and `scripts/` into each worktree
|
||||
- **`files.symlink`**: Symlinks `node_modules` and `.svelte-kit` to avoid reinstalling per worktree
|
||||
|
||||
## Cursor SSH Integration (`wmc`)
|
||||
|
||||
`wm-cursor` (aliased as `wmc`) gives each worktree its own Cursor SSH remote window with an independently-focused tmux session. All windows are visible in the status bar across all Cursor terminals, but each one is focused on its own worktree.
|
||||
|
||||
This uses **grouped tmux sessions** — multiple sessions that share the same window list but track focus independently:
|
||||
|
||||
```
|
||||
tmux session: main <-- your main Cursor terminal
|
||||
tmux session: cursor-feat-a <-- Cursor window for feat-a (focused on wm-feat-a)
|
||||
tmux session: cursor-feat-b <-- Cursor window for feat-b (focused on wm-feat-b)
|
||||
\__ all three share the same windows in the status bar
|
||||
```
|
||||
|
||||
### Setup
|
||||
|
||||
Run once from inside tmux on the remote:
|
||||
|
||||
```bash
|
||||
./scripts/wm-cursor setup /home/hugo/projects/windmill
|
||||
```
|
||||
|
||||
This:
|
||||
|
||||
1. **Merges `.vscode/settings.json`** — adds the `wm-tmux` terminal profile (auto-attaches to the `main` tmux session), disables auto port forwarding, configures forwarding for ports 8000/3000/5432, and stops rust-analyzer from auto-starting. Existing settings are preserved.
|
||||
2. **Creates `.vscode/tasks.json`** — auto-starts the dev database (`start-dev-db.sh`) when the folder opens.
|
||||
3. **Adds `wmc` alias to `~/.zshrc`** — so you can use `wmc` from any tmux window.
|
||||
|
||||
After setup, reopen Cursor's terminal to pick up the new profile.
|
||||
|
||||
### Usage
|
||||
|
||||
All commands run from inside a tmux session (i.e., from Cursor's integrated terminal after setup).
|
||||
|
||||
**Create a new worktree + open Cursor:**
|
||||
|
||||
```bash
|
||||
wmc add -A -p "implement feature X"
|
||||
```
|
||||
|
||||
This runs `workmux add`, creates a grouped tmux session, writes `.vscode/settings.json` in the worktree (with port forwarding matching the worktree's assigned ports), and opens a new Cursor window.
|
||||
|
||||
**Open Cursor for an existing worktree:**
|
||||
|
||||
```bash
|
||||
wmc open my-feature
|
||||
```
|
||||
|
||||
**Close a worktree's Cursor window and tmux window (keeps the worktree):**
|
||||
|
||||
```bash
|
||||
wmc close my-feature
|
||||
```
|
||||
|
||||
This kills the grouped tmux session and calls `workmux close` to close the tmux window. The worktree and branch are preserved. Grouped sessions are also automatically cleaned up when you `workmux rm` a worktree (via `scripts/worktree-cleanup`).
|
||||
|
||||
## Login
|
||||
|
||||
Default credentials: `admin@windmill.dev` / `changeme`
|
||||
|
||||
260
scripts/wm-cursor
Executable file
260
scripts/wm-cursor
Executable file
@@ -0,0 +1,260 @@
|
||||
#!/usr/bin/env zsh
|
||||
emulate -L zsh
|
||||
setopt err_exit no_unset pipe_fail
|
||||
|
||||
# wm-cursor: Manage Cursor SSH remote windows with grouped tmux sessions
|
||||
# Each worktree gets its own Cursor window with an independently-focused
|
||||
# grouped tmux session, sharing the same window list in the status bar.
|
||||
|
||||
# --- Resolve script path (must be at top level, not inside a function) ---
|
||||
|
||||
local script_path=${0:A}
|
||||
|
||||
# --- Resolve Cursor remote CLI (most recently modified) ---
|
||||
|
||||
local -a cursor_bins=(~/.cursor-server/cli/servers/*/server/bin/remote-cli/cursor(NOm))
|
||||
if (( ${#cursor_bins} == 0 )); then
|
||||
print -u2 "Error: Cursor remote CLI not found in ~/.cursor-server/cli/servers/"
|
||||
exit 1
|
||||
fi
|
||||
local cursor_bin=${cursor_bins[1]}
|
||||
|
||||
# --- Refresh Cursor IPC socket (tmux may hold a stale one) ---
|
||||
# Multiple stale sockets may exist; probe to find a live one
|
||||
|
||||
local sock
|
||||
for sock in /tmp/vscode-ipc-*.sock(NOm); do
|
||||
if VSCODE_IPC_HOOK_CLI=$sock $cursor_bin --status &>/dev/null; then
|
||||
export VSCODE_IPC_HOOK_CLI=$sock
|
||||
break
|
||||
fi
|
||||
done
|
||||
|
||||
# --- Helper functions ---
|
||||
|
||||
ensure_tmux() {
|
||||
if [[ -z ${TMUX-} ]]; then
|
||||
print -u2 "Error: Not inside a tmux session"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
check_dev_db() {
|
||||
if ! docker ps --format '{{.Names}}' 2>/dev/null | grep -q '^windmill-db-dev$'; then
|
||||
print -u2 "Warning: windmill-db-dev container is not running"
|
||||
fi
|
||||
}
|
||||
|
||||
setup_grouped_session() {
|
||||
local handle=$1 worktree_path=$2
|
||||
local session_name=cursor-${handle}
|
||||
|
||||
# Detect the current main tmux session
|
||||
local main_session=$(tmux display-message -p '#S')
|
||||
|
||||
# Create grouped session (shares windows with the main session)
|
||||
if ! tmux has-session -t $session_name 2>/dev/null; then
|
||||
tmux new-session -d -t $main_session -s $session_name
|
||||
fi
|
||||
|
||||
# Focus on the worktree's window
|
||||
tmux select-window -t ${session_name}:wm-${handle} 2>/dev/null || true
|
||||
|
||||
# Write .vscode/settings.json in the worktree if it doesn't already exist
|
||||
local settings_file=${worktree_path}/.vscode/settings.json
|
||||
if [[ ! -f $settings_file ]]; then
|
||||
mkdir -p ${settings_file:h}
|
||||
|
||||
# Read ports from .env.local if available
|
||||
local env_file=${worktree_path}/.env.local
|
||||
local ports_config=""
|
||||
if [[ -f $env_file ]]; then
|
||||
local backend_port frontend_port
|
||||
source $env_file
|
||||
backend_port=${BACKEND_PORT-}
|
||||
frontend_port=${FRONTEND_PORT-}
|
||||
if [[ -n $backend_port && -n $frontend_port ]]; then
|
||||
ports_config=',
|
||||
"remote.autoForwardPorts": false,
|
||||
"remote.portsAttributes": {
|
||||
"'$backend_port'": { "label": "Backend", "onAutoForward": "silent" },
|
||||
"'$frontend_port'": { "label": "Frontend", "onAutoForward": "openBrowser" }
|
||||
}'
|
||||
fi
|
||||
fi
|
||||
|
||||
cat > $settings_file <<SETTINGS
|
||||
{
|
||||
"rust-analyzer.initializeStopped": true,
|
||||
"terminal.integrated.defaultProfile.linux": "wm-tmux",
|
||||
"terminal.integrated.profiles.linux": {
|
||||
"wm-tmux": {
|
||||
"path": "tmux",
|
||||
"args": ["attach-session", "-t", "${session_name}"]
|
||||
}
|
||||
}${ports_config}
|
||||
}
|
||||
SETTINGS
|
||||
print "Created ${settings_file}"
|
||||
fi
|
||||
}
|
||||
|
||||
# --- Subcommands ---
|
||||
|
||||
cmd_add() {
|
||||
ensure_tmux
|
||||
check_dev_db
|
||||
|
||||
# Snapshot worktree list before
|
||||
local -a before=("${(@f)$(git worktree list --porcelain | grep '^worktree ')}")
|
||||
local prev_window=$(tmux display-message -p '#I')
|
||||
|
||||
workmux add "$@"
|
||||
tmux select-window -t $prev_window
|
||||
|
||||
# Diff to find the new entry
|
||||
local -a after=("${(@f)$(git worktree list --porcelain | grep '^worktree ')}")
|
||||
local -a new=(${after:|before})
|
||||
|
||||
if (( ${#new} == 0 )); then
|
||||
print -u2 "Error: Could not detect new worktree path"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
local new_path=${new[1]#worktree }
|
||||
local handle=${new_path:t}
|
||||
|
||||
print "New worktree: ${handle} at ${new_path}"
|
||||
setup_grouped_session $handle $new_path
|
||||
$cursor_bin -n $new_path
|
||||
print "Opened Cursor for ${handle}"
|
||||
}
|
||||
|
||||
cmd_open() {
|
||||
local name=${1:?Usage: wm-cursor open <name>}
|
||||
shift
|
||||
|
||||
ensure_tmux
|
||||
check_dev_db
|
||||
|
||||
local wt_path=$(workmux path $name)
|
||||
local prev_window=$(tmux display-message -p '#I')
|
||||
|
||||
workmux open $name "$@"
|
||||
tmux select-window -t $prev_window
|
||||
setup_grouped_session $name $wt_path
|
||||
$cursor_bin -n $wt_path
|
||||
print "Opened Cursor for ${name}"
|
||||
}
|
||||
|
||||
cmd_close() {
|
||||
local name=${1:?Usage: wm-cursor close <name>}
|
||||
|
||||
tmux kill-session -t cursor-${name} 2>/dev/null || true
|
||||
workmux close $name
|
||||
}
|
||||
|
||||
cmd_setup() {
|
||||
local repo_root=${1:?Usage: wm-cursor setup <repo-root>}
|
||||
repo_root=${repo_root:A}
|
||||
local vscode_dir=${repo_root}/.vscode
|
||||
|
||||
mkdir -p $vscode_dir
|
||||
|
||||
# --- tasks.json ---
|
||||
local tasks_file=${vscode_dir}/tasks.json
|
||||
local write_tasks=true
|
||||
if [[ -f $tasks_file ]]; then
|
||||
print -n "tasks.json already exists. Overwrite? [y/N] "
|
||||
read -q || { print; write_tasks=false }
|
||||
print
|
||||
fi
|
||||
if $write_tasks; then
|
||||
cat > $tasks_file <<'TASKS'
|
||||
{
|
||||
"version": "2.0.0",
|
||||
"tasks": [
|
||||
{
|
||||
"label": "Start dev DB",
|
||||
"type": "shell",
|
||||
"command": "./start-dev-db.sh",
|
||||
"options": { "shell": { "executable": "/bin/bash" } },
|
||||
"runOptions": { "runOn": "folderOpen" },
|
||||
"presentation": { "reveal": "silent", "close": true },
|
||||
"problemMatcher": []
|
||||
}
|
||||
]
|
||||
}
|
||||
TASKS
|
||||
print "Wrote ${tasks_file}"
|
||||
fi
|
||||
|
||||
# --- settings.json (merge wm-cursor keys, preserve existing) ---
|
||||
local settings_file=${vscode_dir}/settings.json
|
||||
local wmc_settings='
|
||||
{
|
||||
"rust-analyzer.initializeStopped": true,
|
||||
"terminal.integrated.defaultProfile.linux": "wm-tmux",
|
||||
"terminal.integrated.profiles.linux": {
|
||||
"wm-tmux": {
|
||||
"path": "tmux",
|
||||
"args": ["new-session", "-A", "-s", "main"]
|
||||
}
|
||||
},
|
||||
"remote.autoForwardPorts": false,
|
||||
"remote.portsAttributes": {
|
||||
"8000": { "label": "Backend", "onAutoForward": "silent" },
|
||||
"3000": { "label": "Frontend", "onAutoForward": "openBrowser" },
|
||||
"5432": { "label": "PostgreSQL", "onAutoForward": "silent" }
|
||||
}
|
||||
}'
|
||||
|
||||
if [[ -f $settings_file ]]; then
|
||||
# Strip // comments so jq can parse, merge, then write back
|
||||
local existing
|
||||
existing=$(python3 -c '
|
||||
import json, re, sys
|
||||
text = sys.stdin.read()
|
||||
# Remove // comments only outside of strings
|
||||
text = re.sub(r'"'"'("(?:[^"\\]|\\.)*")|//[^\n]*'"'"', lambda m: m.group(1) or "", text)
|
||||
json.dump(json.loads(text), sys.stdout, indent=2)
|
||||
' < $settings_file)
|
||||
jq --argjson wmc "$wmc_settings" '. * $wmc' <<< "$existing" > ${settings_file}.tmp \
|
||||
&& mv ${settings_file}.tmp $settings_file
|
||||
print "Merged wm-cursor settings into ${settings_file}"
|
||||
else
|
||||
jq . <<< "$wmc_settings" > $settings_file
|
||||
print "Created ${settings_file}"
|
||||
fi
|
||||
|
||||
# --- zsh alias ---
|
||||
local rc=${ZDOTDIR:-$HOME}/.zshrc
|
||||
local alias_line="alias wmc=${(q)script_path}"
|
||||
|
||||
if [[ -f $rc ]] && grep -qF 'alias wmc=' $rc; then
|
||||
sed -i "s|^alias wmc=.*|${alias_line}|" $rc
|
||||
print "Updated wmc alias in ${rc}"
|
||||
else
|
||||
print "\n# wm-cursor alias\n${alias_line}" >> $rc
|
||||
print "Added wmc alias to ${rc}"
|
||||
fi
|
||||
}
|
||||
|
||||
# --- Main ---
|
||||
|
||||
case ${1-} in
|
||||
add) shift; cmd_add "$@" ;;
|
||||
open) shift; cmd_open "$@" ;;
|
||||
close) shift; cmd_close "$@" ;;
|
||||
setup) shift; cmd_setup "$@" ;;
|
||||
*)
|
||||
print -u2 "Usage: wm-cursor <add|open|close|setup> [args...]"
|
||||
print -u2 ""
|
||||
print -u2 "Subcommands:"
|
||||
print -u2 " add [workmux-add-args...] Create worktree + open Cursor"
|
||||
print -u2 " open <name> Open Cursor for existing worktree"
|
||||
print -u2 " close <name> Clean up grouped tmux session"
|
||||
print -u2 " setup <repo-root> Set up .vscode settings, tasks + wmc alias"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
@@ -18,3 +18,6 @@ if [ -d "$ee_worktree_dir" ]; then
|
||||
&& echo "Removed EE worktree at $ee_worktree_dir" \
|
||||
|| echo "Warning: Could not remove EE worktree at $ee_worktree_dir"
|
||||
fi
|
||||
|
||||
# Clean up Cursor grouped tmux session
|
||||
tmux kill-session -t "cursor-${wt_basename}" 2>/dev/null || true
|
||||
|
||||
@@ -1,13 +1,17 @@
|
||||
#!/usr/bin/env bash
|
||||
set -e
|
||||
set -e
|
||||
|
||||
docker run --rm -d \
|
||||
--name windmill-db-dev \
|
||||
-e POSTGRES_PASSWORD=changeme \
|
||||
-e POSTGRES_DB=windmill \
|
||||
-p 5432:5432 \
|
||||
-v windmill_db_data:/var/lib/postgresql/data \
|
||||
postgres:16
|
||||
if docker start windmill-db-dev 2>/dev/null; then
|
||||
echo "PostgreSQL database started (existing container)."
|
||||
else
|
||||
docker run -d \
|
||||
--name windmill-db-dev \
|
||||
-e POSTGRES_PASSWORD=changeme \
|
||||
-e POSTGRES_DB=windmill \
|
||||
-p 5432:5432 \
|
||||
-v windmill_db_data:/var/lib/postgresql/data \
|
||||
postgres:16
|
||||
echo "PostgreSQL database started (new container)."
|
||||
fi
|
||||
|
||||
echo "PostgreSQL database started successfully!"
|
||||
echo "Connection string: postgres://postgres:changeme@localhost:5432/windmill"
|
||||
|
||||
Reference in New Issue
Block a user