@alexcrondon/tx 0.1.0 → 0.1.3

package/README.md

@@ -54,7 +54,7 @@ Config uses two files; the tool writes each key to the appropriate one:
 
 | Scope | File | Keys |
 |-------|------|------|
-| User | `~/.txrc` | code, tunnel, db, auto_open, auto_tmux |
+| User | `~/.txrc` | code, tunnel, db, auto_open, auto_tmux, auto_start |
 | Project | `.txrc` | port, start, url, branch, copy, worktrees_dir, install |
 
 ```bash
@@ -81,6 +81,7 @@ tx config reset user           # Delete ~/.txrc
 | db | user | (empty) | Background db command |
 | auto_open | user | false | Open browser after serv start |
 | auto_tmux | user | false | Auto-launch tx code in tmux |
+| auto_start | user | false | Auto-start dev server with tx code |
 
 ## Examples
 
@@ -99,6 +100,7 @@ tx wt add -b fix/my-bug     # Create worktree fix-my-bug on branch fix/my-bug
 
 # Code editor (creates worktree by default)
 tx code -b fix/my-bug       # Worktree "fix-my-bug" on branch fix/my-bug
+tx code -s -b fix/my-bug    # Same, plus install deps and start dev server
 tx code -r                  # Run in repo root instead
 tx code -t                  # Launch in tmux session
 tx code attach hotfix       # Reattach to tmux

package/lib/code.sh

@@ -10,6 +10,8 @@ cmd_code() {
   local flag_attach=0
   local flag_caffeinate=0
   local flag_install=0
+  local flag_start=0
+  [ "$TX_AUTO_START" = "true" ] && flag_start=1
   local name=""
   local branch=""
   local attach_name=""
@@ -21,6 +23,7 @@ cmd_code() {
       --tunnel|-t)      flag_tunnel=1; shift ;;
       --caffeinate|-c)  flag_caffeinate=1; shift ;;
       --install|-i)     flag_install=1; shift ;;
+      --start|-s)       flag_start=1; shift ;;
       --attach|-a)    flag_attach=1; attach_name="${2:-}"; shift; shift 2>/dev/null || true ;;
       --name=*|-n=*)  name="${1#*=}"; shift ;;
       --name|-n)      name="$2"; shift 2 ;;
@@ -41,7 +44,7 @@ cmd_code() {
     return $?
   fi
 
-  _code_start "$flag_worktree" "$flag_tunnel" "$flag_caffeinate" "$name" "$branch" "$flag_install"
+  _code_start "$flag_worktree" "$flag_tunnel" "$flag_caffeinate" "$name" "$branch" "$flag_install" "$flag_start"
 }
 
 _code_start() {
@@ -51,8 +54,14 @@ _code_start() {
   local name="$4"
   local branch="$5"
   local flag_install="${6:-0}"
+  local flag_start="${7:-0}"
   local work_dir="$PWD"
 
+  # Start implies install — always install before starting
+  if [ "$flag_start" -eq 1 ]; then
+    flag_install=1
+  fi
+
   if [ "$flag_worktree" -eq 1 ]; then
     local wt_args=""
     [ -n "$name" ] && wt_args="$wt_args --name $name"
@@ -67,6 +76,12 @@ _code_start() {
     cd "$work_dir" || return 1
   fi
 
+  # Start dev server if requested
+  if [ "$flag_start" -eq 1 ]; then
+    cd "$work_dir" || return 1
+    _serv_start 0 0 "" ""
+  fi
+
   local session_name
   local detected_name
   detected_name=$(tx_detect_worktree_name) || true

package/lib/common.sh

@@ -21,12 +21,13 @@ TX_TUNNEL_CMD="${TX_TUNNEL_CMD:-ngrok tcp 22}"
 TX_DB_CMD="${TX_DB_CMD:-}"
 TX_AUTO_OPEN="${TX_AUTO_OPEN:-false}"
 TX_AUTO_TMUX="${TX_AUTO_TMUX:-false}"
+TX_AUTO_START="${TX_AUTO_START:-false}"
 TX_INSTALL_CMD="${TX_INSTALL_CMD:-yarn install}"
 
 # Config scopes: user (~/.txrc) vs project (.txrc)
-TX_CONFIG_USER_KEYS="code tunnel auto_open db auto_tmux"
+TX_CONFIG_USER_KEYS="code tunnel auto_open db auto_tmux auto_start"
 TX_CONFIG_PROJECT_KEYS="port start url branch copy worktrees_dir install"
-TX_CONFIG_KEYS="port start url branch copy worktrees_dir install code tunnel db auto_open auto_tmux"
+TX_CONFIG_KEYS="port start url branch copy worktrees_dir install code tunnel db auto_open auto_tmux auto_start"
 
 # --- Config key-to-variable mapping ---
 tx_config_var() {
@@ -43,6 +44,7 @@ tx_config_var() {
     auto_open)     echo "TX_AUTO_OPEN" ;;
     install)       echo "TX_INSTALL_CMD" ;;
     auto_tmux)     echo "TX_AUTO_TMUX" ;;
+    auto_start)    echo "TX_AUTO_START" ;;
     *)             echo "" ;;
   esac
 }
@@ -62,6 +64,7 @@ tx_config_default() {
     auto_open)     echo "false" ;;
     install)       echo "yarn install" ;;
     auto_tmux)     echo "false" ;;
+    auto_start)    echo "false" ;;
   esac
 }
 
@@ -113,7 +116,7 @@ _tx_config_apply_file "$(_tx_project_root)/.txrc" $TX_CONFIG_PROJECT_KEYS
 
 # Hash a directory path to a safe filename (MD5)
 tx_hash_dir() {
-  echo -n "$1" | md5 -q 2>/dev/null || echo -n "$1" | md5sum | cut -d' ' -f1
+  printf '%s' "$1" | md5 -q 2>/dev/null || printf '%s' "$1" | md5sum | cut -d' ' -f1
 }
 
 # Ensure /tmp/tx-serv/ directory exists

package/lib/completions.sh

@@ -14,7 +14,7 @@ _tx() {
   case "${words[2]}" in
     config)
       if [ "$CURRENT" -eq 3 ]; then
-        compadd port start url branch copy worktrees_dir code tunnel db auto_open init reset
+        compadd port start url branch copy worktrees_dir code tunnel db auto_open auto_tmux auto_start install init reset
       elif [ "$CURRENT" -eq 4 ] && [ "${words[3]}" = "reset" ]; then
         compadd user project
       fi
@@ -49,7 +49,7 @@ _tx() {
       if [ "$CURRENT" -eq 3 ]; then
         compadd start attach
       else
-        compadd -- --root --tunnel --name --branch --attach --caffeinate
+        compadd -- --root --tunnel --name --branch --attach --caffeinate --install --start
       fi
       ;;
   esac

package/lib/help.sh

@@ -11,7 +11,7 @@ Usage:
   tx config reset [user|project]  Delete config file (with confirmation)
 
 Keys:
-  User (~/.txrc):   code, tunnel, auto_open, db, auto_tmux
+  User (~/.txrc):   code, tunnel, auto_open, db, auto_tmux, auto_start
   Project (.txrc):  port, start, url, branch, copy, worktrees_dir
 EOF
 }
@@ -96,6 +96,7 @@ Flags:
   -a, --attach              Attach to existing session
   -c, --caffeinate          Prevent sleep
   -i, --install             Run install command after creating worktree (TX_INSTALL_CMD)
+  -s, --start               Run dev server after install (TX_START_CMD)
 EOF
 }
 

package/lib/serv.sh

@@ -163,6 +163,17 @@ _serv_start() {
     cmd="$TX_START_CMD"
   fi
 
+  # Warn if npm/yarn will walk up to a parent package.json
+  if [ ! -f "package.json" ]; then
+    case "$cmd" in
+      npm*|yarn*|npx*)
+        echo "Warning: No package.json in $PWD" >&2
+        echo "  $cmd will use a parent directory's package.json instead." >&2
+        echo "  The server may start from the wrong directory." >&2
+        ;;
+    esac
+  fi
+
   # Write state files
   echo "$port" > "$(_serv_file "$hash" port)"
   echo "$PWD" > "$(_serv_file "$hash" dir)"

package/lib/wt.sh

@@ -74,8 +74,11 @@ _wt_add() {
   # Create worktree
   if [ -n "$branch" ]; then
     if git show-ref --verify --quiet "refs/heads/${branch}" 2>/dev/null; then
-      # Existing branch
+      # Existing local branch
       git worktree add "$worktree_path" "$branch"
+    elif git show-ref --verify --quiet "refs/remotes/origin/${branch}" 2>/dev/null; then
+      # Existing remote branch — check it out locally
+      git worktree add --track -b "$branch" "$worktree_path" "origin/${branch}"
     else
       # New branch from default
       git worktree add -b "$branch" "$worktree_path" "$TX_DEFAULT_BRANCH"
@@ -88,6 +91,9 @@ _wt_add() {
   # Copy configured files
   _wt_copy_files "$worktree_path"
 
+  # Symlink .claude/ so worktrees inherit permissions and settings
+  _wt_link_claude_config "$worktree_path"
+
   # Symlink node_modules from repo root if it exists
   _wt_link_node_modules "$worktree_path"
 
@@ -145,6 +151,17 @@ _wt_copy_files() {
   done
 }
 
+_wt_link_claude_config() {
+  local target_dir="$1"
+  local repo_root
+  repo_root=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+
+  [ -d "$repo_root/.claude" ] || return 0
+  [ -e "$target_dir/.claude" ] && return 0
+
+  ln -s "$repo_root/.claude" "$target_dir/.claude"
+}
+
 _wt_link_node_modules() {
   # No-op: node_modules is not copied or symlinked into worktrees.
   # Symlinks break yarn v1 (can't resolve nested deps through them),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexcrondon/tx",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Modular CLI for isolated dev environments using git worktrees",
   "bin": {
     "tx": "./bin/tx"
@@ -9,5 +9,8 @@
     "bin/",
     "lib/"
   ],
+  "scripts": {
+    "publish": "sh scripts/publish.sh"
+  },
   "license": "MIT"
 }