@alexcrondon/tx 0.1.0

package/lib/completions.sh

@@ -0,0 +1,59 @@
+# lib/completions.sh — tx completions command
+
+cmd_completions() {
+  cat << 'EOF'
+# tx shell completions
+_tx() {
+  local commands="config status serv tunnel db wt code nuke completions help"
+
+  if [ "$CURRENT" -eq 2 ]; then
+    compadd ${=commands}
+    return
+  fi
+
+  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
+      elif [ "$CURRENT" -eq 4 ] && [ "${words[3]}" = "reset" ]; then
+        compadd user project
+      fi
+      ;;
+    serv)
+      if [ "$CURRENT" -eq 3 ]; then
+        compadd start stop restart open list log
+      else
+        compadd -- --open --front --port
+      fi
+      ;;
+    tunnel)
+      if [ "$CURRENT" -eq 3 ]; then
+        compadd start stop status
+      else
+        compadd -- --caffeinate
+      fi
+      ;;
+    db)
+      if [ "$CURRENT" -eq 3 ]; then
+        compadd start stop status log
+      fi
+      ;;
+    wt)
+      if [ "$CURRENT" -eq 3 ]; then
+        compadd add remove list clean
+      else
+        compadd -- --name --branch
+      fi
+      ;;
+    code)
+      if [ "$CURRENT" -eq 3 ]; then
+        compadd start attach
+      else
+        compadd -- --root --tunnel --name --branch --attach --caffeinate
+      fi
+      ;;
+  esac
+}
+compdef _tx tx
+EOF
+}

package/lib/config.sh

@@ -0,0 +1,174 @@
+# lib/config.sh — tx config command
+
+cmd_config() {
+  local subcommand="${1:-}"
+  shift 2>/dev/null || true
+
+  # tx config init
+  if [ "$subcommand" = "init" ]; then
+    _config_init
+    return $?
+  fi
+
+  # tx config reset [user|project]
+  if [ "$subcommand" = "reset" ]; then
+    local target="${1:-project}"
+    local file=""
+    case "$target" in
+      user)    file="${HOME}/.txrc" ;;
+      project) file=".txrc" ;;
+      *)
+        echo "tx config reset: unknown target '$target'"
+        echo "Usage: tx config reset [user|project]"
+        return 1
+        ;;
+    esac
+    if [ ! -f "$file" ]; then
+      echo "No config file found: $file"
+    else
+      printf "Delete %s? [y/N] " "$file"
+      read -r answer
+      case "$answer" in
+        y|Y|yes|YES) rm -f "$file"; echo "Deleted $file" ;;
+        *) echo "Aborted." ;;
+      esac
+    fi
+    return 0
+  fi
+
+  # tx config (no args) — show current config
+  if [ -z "$subcommand" ]; then
+    echo "Configuration (user: ~/.txrc, project: .txrc)"
+    echo ""
+    for key in $TX_CONFIG_KEYS; do
+      local var scope
+      var=$(tx_config_var "$key")
+      scope=$(tx_config_scope "$key")
+      eval "local val=\$$var"
+      printf "  %-15s %-8s %s\n" "$key" "($scope)" "$val"
+    done
+    return 0
+  fi
+
+  # tx config <key> <value>
+  local key="$subcommand"
+  local value="${1:-}"
+
+  if [ -z "$value" ]; then
+    # Show single key value
+    local var
+    var=$(tx_config_var "$key")
+    if [ -z "$var" ]; then
+      echo "Unknown config key: $key"
+      echo "Available keys: $TX_CONFIG_KEYS"
+      return 1
+    fi
+    eval "local val=\$$var"
+    echo "$val"
+    return 0
+  fi
+
+  local var scope file
+  var=$(tx_config_var "$key")
+  if [ -z "$var" ]; then
+    echo "Unknown config key: $key"
+    echo "Available keys: $TX_CONFIG_KEYS"
+    return 1
+  fi
+
+  scope=$(tx_config_scope "$key")
+  file=$(tx_config_file "$scope")
+  [ -f "$file" ] || touch "$file"
+
+  # --unset: remove the key from the config file, reverting to default
+  if [ "$value" = "--unset" ]; then
+    grep -v "^${var}=" "$file" > "$file.tmp" 2>/dev/null || true
+    mv "$file.tmp" "$file"
+    local default
+    default=$(tx_config_default "$key")
+    if [ -n "$default" ]; then
+      echo "Unset $key, reverted to default: $default ($scope: $file)"
+    else
+      echo "Unset $key ($scope: $file)"
+    fi
+    return 0
+  fi
+
+  # Update or append (grep+sed is unsafe with special chars, so delete+append)
+  grep -v "^${var}=" "$file" > "$file.tmp" 2>/dev/null || true
+  printf '%s="%s"\n' "$var" "$value" >> "$file.tmp"
+  mv "$file.tmp" "$file"
+
+  echo "Set $key = $value ($scope: $file)"
+}
+
+_config_init() {
+  echo "Initializing config — press Enter to keep default."
+  echo "User config: ~/.txrc | Project config: .txrc"
+  echo ""
+
+  for key in $TX_CONFIG_KEYS; do
+    local var scope file
+    var=$(tx_config_var "$key")
+    scope=$(tx_config_scope "$key")
+    file=$(tx_config_file "$scope")
+    eval "local default=\$$var"
+
+    if [ -n "$default" ]; then
+      printf "  %s (%s) [%s]: " "$key" "$scope" "$default"
+    else
+      printf "  %s (%s) (no default): " "$key" "$scope"
+    fi
+
+    read -r input
+    if [ -n "$input" ]; then
+      [ -f "$file" ] || touch "$file"
+      grep -v "^${var}=" "$file" > "$file.tmp" 2>/dev/null || true
+      printf '%s="%s"\n' "$var" "$input" >> "$file.tmp"
+      mv "$file.tmp" "$file"
+    fi
+  done
+
+  echo ""
+
+  # Offer to enable Claude Code sandbox for this project
+  printf "  Enable Claude Code sandbox for this project? (y/N)\n"
+  printf "  (This will modify .claude/settings.local.json in this repo)\n"
+  printf "  > "
+  read -r sandbox_answer
+  case "$sandbox_answer" in
+    y|Y|yes|YES)
+      _config_enable_sandbox
+      ;;
+  esac
+
+  echo ""
+  echo "Done."
+}
+
+_config_enable_sandbox() {
+  local settings_dir=".claude"
+  local settings_file="$settings_dir/settings.local.json"
+
+  mkdir -p "$settings_dir"
+
+  if [ ! -f "$settings_file" ]; then
+    # Create new settings file with sandbox config
+    cat > "$settings_file" <<'SETTINGS'
+{
+  "sandbox": {
+    "enabled": true,
+    "autoAllow": true
+  }
+}
+SETTINGS
+    echo "  Created $settings_file with sandbox enabled."
+  elif grep -q '"sandbox"' "$settings_file" 2>/dev/null; then
+    echo "  Sandbox already configured in $settings_file."
+  else
+    # Insert sandbox config after opening brace
+    sed '1s/{/{\'$'\n'"  \"sandbox\": { \"enabled\": true, \"autoAllow\": true },/" "$settings_file" > "$settings_file.tmp"
+    mv "$settings_file.tmp" "$settings_file"
+    echo "  Added sandbox config to $settings_file."
+  fi
+}

package/lib/db.sh

@@ -0,0 +1,91 @@
+# lib/db.sh — tx db command
+
+TX_DB_PID_FILE="/tmp/tx-db.pid"
+TX_DB_LOG_FILE="/tmp/tx-db.log"
+
+cmd_db() {
+  local subcommand="${1:-status}"
+  shift 2>/dev/null || true
+
+  case "$subcommand" in
+    start)  _db_start ;;
+    stop)   _db_stop ;;
+    status) _db_status ;;
+    log)    _db_log ;;
+    *)
+      echo "tx db: unknown subcommand '$subcommand'"
+      echo "Usage: tx db [start|stop|status|log]"
+      return 1
+      ;;
+  esac
+}
+
+_db_start() {
+  if [ -z "$TX_DB_CMD" ]; then
+    echo "No db command configured."
+    echo "Set one with: tx config db \"<command>\""
+    return 1
+  fi
+
+  # Check if already running
+  if [ -f "$TX_DB_PID_FILE" ]; then
+    local pid
+    pid=$(cat "$TX_DB_PID_FILE")
+    if tx_is_alive "$pid"; then
+      echo "Already running (PID $pid)."
+      return 1
+    else
+      rm -f "$TX_DB_PID_FILE"
+    fi
+  fi
+
+  echo "Starting: $TX_DB_CMD"
+  eval "$TX_DB_CMD" > "$TX_DB_LOG_FILE" 2>&1 &
+  echo $! > "$TX_DB_PID_FILE"
+  echo "Running (PID $!)."
+}
+
+_db_stop() {
+  if [ ! -f "$TX_DB_PID_FILE" ]; then
+    echo "Not running."
+    return 0
+  fi
+
+  local pid
+  pid=$(cat "$TX_DB_PID_FILE")
+  if tx_is_alive "$pid"; then
+    kill "$pid" 2>/dev/null || true
+    pkill -P "$pid" 2>/dev/null || true
+    echo "Stopped (PID $pid)."
+  else
+    echo "Not running (stale PID)."
+  fi
+  rm -f "$TX_DB_PID_FILE"
+  rm -f "$TX_DB_LOG_FILE"
+}
+
+_db_status() {
+  if [ ! -f "$TX_DB_PID_FILE" ]; then
+    echo "Not running."
+    return 0
+  fi
+
+  local pid
+  pid=$(cat "$TX_DB_PID_FILE")
+  if tx_is_alive "$pid"; then
+    echo "Running (PID $pid)"
+    echo "Command: $TX_DB_CMD"
+  else
+    echo "Not running (stale PID)."
+    rm -f "$TX_DB_PID_FILE"
+  fi
+}
+
+_db_log() {
+  if [ ! -f "$TX_DB_LOG_FILE" ]; then
+    echo "No log file. Is db running?"
+    return 1
+  fi
+
+  cat "$TX_DB_LOG_FILE"
+}

package/lib/help.sh

@@ -0,0 +1,192 @@
+# lib/help.sh — tx help command
+
+_help_config() {
+  cat << 'EOF'
+tx config — Manage configuration (user: ~/.txrc, project: .txrc)
+
+Usage:
+  tx config                 Show current configuration
+  tx config <key> <value>   Set a configuration value
+  tx config init            Interactive setup (writes to appropriate file per key)
+  tx config reset [user|project]  Delete config file (with confirmation)
+
+Keys:
+  User (~/.txrc):   code, tunnel, auto_open, db, auto_tmux
+  Project (.txrc):  port, start, url, branch, copy, worktrees_dir
+EOF
+}
+
+_help_serv() {
+  cat << 'EOF'
+tx serv — Manage dev servers
+
+Usage:
+  tx serv                   List all running servers (default)
+  tx serv start             Start dev server (background by default)
+  tx serv start "<cmd>"     Start with custom command
+  tx serv stop              Stop server for current directory
+  tx serv stop all          Stop all tx-managed servers
+  tx serv restart           Restart server (same port)
+  tx serv open              Open dev URL in browser
+  tx serv log               Show server output log
+
+Flags:
+  -o, --open                Open browser after starting
+  -f, --front               Run in foreground
+  -p, --port N              Use specific port
+EOF
+}
+
+_help_tunnel() {
+  cat << 'EOF'
+tx tunnel — Manage SSH tunnels (ngrok)
+
+Usage:
+  tx tunnel                 Show tunnel status (default)
+  tx tunnel start           Start SSH tunnel
+  tx tunnel stop            Stop SSH tunnel
+
+Flags:
+  -c, --caffeinate          Prevent sleep while tunnel is open
+EOF
+}
+
+_help_db() {
+  cat << 'EOF'
+tx db — Manage background db process (port-forward, etc.)
+
+Usage:
+  tx db                     Show db process status (default)
+  tx db start               Start configured db command in background
+  tx db stop                Stop the db process
+  tx db log                 Show db process output
+EOF
+}
+
+_help_wt() {
+  cat << 'EOF'
+tx wt — Manage git worktrees
+
+Usage:
+  tx wt                     List all worktrees (default)
+  tx wt add                 Create/reuse a git worktree
+  tx wt remove              Remove a worktree (and its server)
+  tx wt clean               Remove all worktrees
+
+Flags:
+  -n, --name NAME           Worktree name
+  -b, --branch BRANCH       Branch to checkout (also used as worktree name if -n omitted, / → -)
+  -i, --install             Run install command after creating worktree (TX_INSTALL_CMD)
+EOF
+}
+
+_help_code() {
+  cat << 'EOF'
+tx code — Launch code editors/agents (claude, tmux)
+
+Usage:
+  tx code                   Launch in worktree (default), or repo root with -r
+  tx code attach [name]     Attach to tmux session (interactive picker if no name)
+
+Flags:
+  -r, --root                Run in repo root instead of worktree
+  -t, --tunnel              Launch in tmux session
+  -n, --name NAME           Worktree/session name
+  -b, --branch BRANCH       Branch to checkout (also used as worktree name, / → -)
+  -a, --attach              Attach to existing session
+  -c, --caffeinate          Prevent sleep
+  -i, --install             Run install command after creating worktree (TX_INSTALL_CMD)
+EOF
+}
+
+_help_nuke() {
+  cat << 'EOF'
+tx nuke — Stop everything and remove all worktrees
+
+Usage:
+  tx nuke                   Stop all servers, tunnels, db, remove worktrees (with confirmation)
+EOF
+}
+
+_help_status() {
+  cat << 'EOF'
+tx status — Show status of all managed processes
+
+Usage:
+  tx status                 Show sessions, servers, tunnel, db, and worktree status
+
+Sessions are listed globally (all tx tmux sessions across all projects).
+EOF
+}
+
+_help_completions() {
+  cat << 'EOF'
+tx completions — Output zsh completion script
+
+Usage:
+  tx completions            Print zsh completions (eval or source in .zshrc)
+EOF
+}
+
+_help_overview() {
+  cat << 'EOF'
+tx — modular CLI for isolated dev environments
+
+Usage: tx [command] [subcommand] [flags]
+        (no command = status)
+
+Commands:
+  config                    Manage project configuration (.txrc)
+  status                    Show status (default when no command given)
+  serv                      Manage dev servers (list by default)
+  tunnel                    Manage SSH tunnels (status by default)
+  db                        Manage background db process (status by default)
+  wt                        Manage git worktrees (list by default)
+  code                      Launch code editors/agents (claude, tmux)
+  nuke                      Stop everything and remove all worktrees
+  completions               Output zsh completion script
+  help                      Show this help message
+
+Run 'tx help <command>' for details on a specific command.
+
+Examples:
+  tx                        Show status (default)
+  tx serv                   List running servers
+  tx serv start -o -p 3000  Start on port 3000, open browser
+  tx serv stop all          Kill all dev servers
+  tx wt add -n hotfix       Create worktree named "hotfix"
+  tx wt add -b fix/my-bug   Create worktree fix-my-bug on branch fix/my-bug
+  tx code -b fix/my-bug     Create worktree fix-my-bug on branch fix/my-bug
+  tx code -t                Create worktree + launch in tmux session
+  tx code attach hotfix     Reattach to tmux session
+  tx tunnel start -c        Start SSH tunnel with caffeinate
+  tx config start "npm start"  Set default start command
+EOF
+}
+
+cmd_help() {
+  local command="${1:-}"
+
+  if [ -z "$command" ]; then
+    _help_overview
+    return 0
+  fi
+
+  case "$command" in
+    config)      _help_config ;;
+    serv)        _help_serv ;;
+    tunnel)      _help_tunnel ;;
+    db)          _help_db ;;
+    wt)          _help_wt ;;
+    code)        _help_code ;;
+    nuke)        _help_nuke ;;
+    status)      _help_status ;;
+    completions) _help_completions ;;
+    help)        echo "Usage: tx help [command]" ;;
+    *)
+      echo "tx help: unknown command '$command'"
+      echo "Run 'tx help' for a list of commands."
+      return 1
+      ;;
+  esac
+}

package/lib/nuke.sh

@@ -0,0 +1,58 @@
+# lib/nuke.sh — tx nuke command
+
+# Source dependencies
+. "$TX_ROOT/lib/serv.sh"
+. "$TX_ROOT/lib/tunnel.sh"
+. "$TX_ROOT/lib/db.sh"
+. "$TX_ROOT/lib/wt.sh"
+
+cmd_nuke() {
+  printf "This will stop all services and remove all worktrees. Continue? [y/N] "
+  read -r answer
+  case "$answer" in
+    y|Y|yes|YES) ;;
+    *) echo "Aborted."; return 0 ;;
+  esac
+
+  echo "=== Stopping all servers ==="
+  _serv_stop "all"
+
+  echo ""
+  echo "=== Stopping tunnel ==="
+  _tunnel_stop
+
+  echo ""
+  echo "=== Stopping db ==="
+  _db_stop
+
+  echo ""
+  echo "=== Killing caffeinate ==="
+  local killed=0
+  if [ -f "/tmp/tx-tunnel-caff.pid" ]; then
+    local cpid
+    cpid=$(cat "/tmp/tx-tunnel-caff.pid")
+    kill "$cpid" 2>/dev/null || true
+    rm -f "/tmp/tx-tunnel-caff.pid"
+    killed=1
+  fi
+  pkill -f "caffeinate -dims" 2>/dev/null && killed=1 || true
+  [ "$killed" -eq 1 ] && echo "Stopped." || echo "Not running."
+
+  echo ""
+  echo "=== Killing tx tmux sessions ==="
+  local sessions
+  sessions=$(tx_list_sessions)
+  if [ -n "$sessions" ]; then
+    echo "$sessions" | while IFS= read -r s; do
+      local display
+      display=$(tx_display_name "$s")
+      tmux kill-session -t "$s" 2>/dev/null && echo "Killed: $display" || true
+    done
+  else
+    echo "  (none)"
+  fi
+
+  echo ""
+  echo "=== Removing worktrees ==="
+  _wt_clean --yes
+}