feat: claude-code workspace persistence

registry/coder/modules/claude-code/README.md

@@ -14,7 +14,7 @@ Run the [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude
 ```tf
 module "claude-code" {
   source              = "registry.coder.com/coder/claude-code/coder"
-  version             = "1.3.1"
+  version             = "1.4.0"
   agent_id            = coder_agent.example.id
   folder              = "/home/coder"
   install_claude_code = true
@@ -88,7 +88,7 @@ resource "coder_agent" "main" {
 module "claude-code" {
   count               = data.coder_workspace.me.start_count
   source              = "registry.coder.com/coder/claude-code/coder"
-  version             = "1.3.1"
+  version             = "1.4.0"
   agent_id            = coder_agent.example.id
   folder              = "/home/coder"
   install_claude_code = true
@@ -100,14 +100,37 @@ module "claude-code" {
 }
 ```
 
+## Session Persistence (Experimental)
+
+Enable automatic session persistence to maintain Claude Code sessions across workspace restarts:
+
+```tf
+module "claude-code" {
+  count               = data.coder_workspace.me.start_count
+  source              = "registry.coder.com/coder/claude-code/coder"
+  version             = "1.4.0"
+  agent_id            = coder_agent.example.id
+  folder              = "/home/coder"
+  install_claude_code = true
+
+  # Enable tmux with session persistence
+  experiment_use_tmux                   = true
+  experiment_tmux_session_persistence   = true
+  experiment_tmux_session_save_interval = "10" # Save every 10 minutes
+  experiment_report_tasks               = true
+}
+```
+
+Session persistence automatically saves and restores your Claude Code environment, including working directory and command history.
+
 ## Run standalone
 
 Run Claude Code as a standalone app in your workspace. This will install Claude Code and run it directly without using screen or any task reporting to the Coder UI.
 
 ```tf
 module "claude-code" {
   source              = "registry.coder.com/coder/claude-code/coder"
-  version             = "1.3.1"
+  version             = "1.4.0"
   agent_id            = coder_agent.example.id
   folder              = "/home/coder"
   install_claude_code = true

registry/coder/modules/claude-code/main.tf

@@ -84,6 +84,18 @@ variable "experiment_post_install_script" {
   default     = null
 }
 
+variable "experiment_tmux_session_persistence" {
+  type        = bool
+  description = "Whether to enable tmux session persistence across workspace restarts."
+  default     = false
+}
+
+variable "experiment_tmux_session_save_interval" {
+  type        = string
+  description = "How often to save tmux sessions in minutes."
+  default     = "15"
+}
+
 locals {
   encoded_pre_install_script  = var.experiment_pre_install_script != null ? base64encode(var.experiment_pre_install_script) : ""
   encoded_post_install_script = var.experiment_post_install_script != null ? base64encode(var.experiment_post_install_script) : ""
@@ -98,12 +110,28 @@ resource "coder_script" "claude_code" {
     #!/bin/bash
     set -e
 
-    # Function to check if a command exists
     command_exists() {
       command -v "$1" >/dev/null 2>&1
     }
 
-    # Check if the specified folder exists
+    install_tmux() {
+      echo "Installing tmux..."
+      if command_exists apt-get; then
+        sudo apt-get update && sudo apt-get install -y tmux
+      elif command_exists yum; then
+        sudo yum install -y tmux
+      elif command_exists dnf; then
+        sudo dnf install -y tmux
+      elif command_exists pacman; then
+        sudo pacman -S --noconfirm tmux
+      elif command_exists apk; then
+        sudo apk add tmux
+      else
+        echo "Error: Unable to install tmux automatically. Package manager not recognized."
+        exit 1
+      fi
+    }
+
     if [ ! -d "${var.folder}" ]; then
       echo "Warning: The specified folder '${var.folder}' does not exist."
       echo "Creating the folder..."
@@ -112,20 +140,37 @@ resource "coder_script" "claude_code" {
       mkdir -p "${var.folder}"
       echo "Folder created successfully."
     fi
-
-    # Run pre-install script if provided
     if [ -n "${local.encoded_pre_install_script}" ]; then
       echo "Running pre-install script..."
       echo "${local.encoded_pre_install_script}" | base64 -d > /tmp/pre_install.sh
       chmod +x /tmp/pre_install.sh
       /tmp/pre_install.sh
     fi
 
-    # Install Claude Code if enabled
     if [ "${var.install_claude_code}" = "true" ]; then
       if ! command_exists npm; then
-        echo "Error: npm is not installed. Please install Node.js and npm first."
-        exit 1
+        echo "npm not found, checking for Node.js installation..."
+        if ! command_exists node; then
+          echo "Node.js not found, installing Node.js via NVM..."
+          export NVM_DIR="$HOME/.nvm"
+          if [ ! -d "$NVM_DIR" ]; then
+            mkdir -p "$NVM_DIR"
+            curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+            [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+          else
+            [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+          fi
+
+          nvm install --lts
+          nvm use --lts
+          nvm alias default node
+
+          echo "Node.js installed: $(node --version)"
+          echo "npm installed: $(npm --version)"
+        else
+          echo "Node.js is installed but npm is not available. Please install npm manually."
+          exit 1
+        fi
       fi
       echo "Installing Claude Code..."
       npm install -g @anthropic-ai/claude-code@${var.claude_code_version}
@@ -136,54 +181,104 @@ resource "coder_script" "claude_code" {
       coder exp mcp configure claude-code ${var.folder}
     fi
 
-    # Run post-install script if provided
     if [ -n "${local.encoded_post_install_script}" ]; then
       echo "Running post-install script..."
       echo "${local.encoded_post_install_script}" | base64 -d > /tmp/post_install.sh
       chmod +x /tmp/post_install.sh
       /tmp/post_install.sh
     fi
 
-    # Handle terminal multiplexer selection (tmux or screen)
     if [ "${var.experiment_use_tmux}" = "true" ] && [ "${var.experiment_use_screen}" = "true" ]; then
       echo "Error: Both experiment_use_tmux and experiment_use_screen cannot be true simultaneously."
       echo "Please set only one of them to true."
       exit 1
     fi
 
-    # Run with tmux if enabled
-    if [ "${var.experiment_use_tmux}" = "true" ]; then
-      echo "Running Claude Code in the background with tmux..."
+    if [ "${var.experiment_tmux_session_persistence}" = "true" ] && [ "${var.experiment_use_tmux}" != "true" ]; then
+      echo "Error: Session persistence requires tmux to be enabled."
+      echo "Please set experiment_use_tmux = true when using session persistence."
+      exit 1
+    fi
 
-      # Check if tmux is installed
+    if [ "${var.experiment_use_tmux}" = "true" ]; then
       if ! command_exists tmux; then
-        echo "Error: tmux is not installed. Please install tmux manually."
-        exit 1
+        install_tmux
       fi
 
-      touch "$HOME/.claude-code.log"
+      if [ "${var.experiment_tmux_session_persistence}" = "true" ]; then
+        echo "Setting up tmux session persistence..."
+        if ! command_exists git; then
+          echo "Git not found, installing git..."
+          if command_exists apt-get; then
+            sudo apt-get update && sudo apt-get install -y git
+          elif command_exists yum; then
+            sudo yum install -y git
+          elif command_exists dnf; then
+            sudo dnf install -y git
+          elif command_exists pacman; then
+            sudo pacman -S --noconfirm git
+          elif command_exists apk; then
+            sudo apk add git
+          else
+            echo "Error: Unable to install git automatically. Package manager not recognized."
+            echo "Please install git manually to enable session persistence."
+            exit 1
+          fi
+        fi
+
+        mkdir -p ~/.tmux/plugins
+        if [ ! -d ~/.tmux/plugins/tpm ]; then
+          git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
+        fi
+
+        cat > ~/.tmux.conf << EOF
+# Claude Code tmux persistence configuration
+set -g @plugin 'tmux-plugins/tmux-resurrect'
+set -g @plugin 'tmux-plugins/tmux-continuum'
+
+# Configure session persistence
+set -g @resurrect-processes ':all:'
+set -g @resurrect-capture-pane-contents 'on'
+set -g @resurrect-save-bash-history 'on'
+set -g @continuum-restore 'on'
+set -g @continuum-save-interval '${var.experiment_tmux_session_save_interval}'
+set -g @continuum-boot 'on'
+set -g @continuum-save-on 'on'
+
+# Initialize plugin manager
+run '~/.tmux/plugins/tpm/tpm'
+EOF
+
+        ~/.tmux/plugins/tpm/scripts/install_plugins.sh
+      fi
 
+      echo "Running Claude Code in the background with tmux..."
+      touch "$HOME/.claude-code.log"
       export LANG=en_US.UTF-8
       export LC_ALL=en_US.UTF-8
 
-      # Create a new tmux session in detached mode
-      tmux new-session -d -s claude-code -c ${var.folder} "claude --dangerously-skip-permissions \"$CODER_MCP_CLAUDE_TASK_PROMPT\""
-
+      if [ "${var.experiment_tmux_session_persistence}" = "true" ]; then
+        sleep 3
+
+        if ! tmux has-session -t claude-code 2>/dev/null; then
+          # Only create a new session if one doesn't exist
+          tmux new-session -d -s claude-code -c ${var.folder} "claude --dangerously-skip-permissions \"$CODER_MCP_CLAUDE_TASK_PROMPT\""
+        fi
+      else
+        if ! tmux has-session -t claude-code 2>/dev/null; then
+          tmux new-session -d -s claude-code -c ${var.folder} "claude --dangerously-skip-permissions \"$CODER_MCP_CLAUDE_TASK_PROMPT\""
+        fi
+      fi
     fi
 
-    # Run with screen if enabled
     if [ "${var.experiment_use_screen}" = "true" ]; then
       echo "Running Claude Code in the background..."
-
-      # Check if screen is installed
       if ! command_exists screen; then
         echo "Error: screen is not installed. Please install screen manually."
         exit 1
       fi
 
       touch "$HOME/.claude-code.log"
-
-      # Ensure the screenrc exists
       if [ ! -f "$HOME/.screenrc" ]; then
         echo "Creating ~/.screenrc and adding multiuser settings..." | tee -a "$HOME/.claude-code.log"
         echo -e "multiuser on\nacladd $(whoami)" > "$HOME/.screenrc"
@@ -198,6 +293,7 @@ resource "coder_script" "claude_code" {
         echo "Adding 'acladd $(whoami)' to ~/.screenrc..." | tee -a "$HOME/.claude-code.log"
         echo "acladd $(whoami)" >> "$HOME/.screenrc"
       fi
+
       export LANG=en_US.UTF-8
       export LC_ALL=en_US.UTF-8
 
@@ -207,7 +303,6 @@ resource "coder_script" "claude_code" {
         exec bash
       '
     else
-      # Check if claude is installed before running
       if ! command_exists claude; then
         echo "Error: Claude Code is not installed. Please enable install_claude_code or install it manually."
         exit 1
@@ -231,6 +326,10 @@ resource "coder_app" "claude_code" {
     if [ "${var.experiment_use_tmux}" = "true" ]; then
       if tmux has-session -t claude-code 2>/dev/null; then
         echo "Attaching to existing Claude Code tmux session." | tee -a "$HOME/.claude-code.log"
+        # If Claude isn't running in the session, start it without the prompt
+        if ! tmux list-panes -t claude-code -F '#{pane_current_command}' | grep -q "claude"; then
+          tmux send-keys -t claude-code "cd ${var.folder} && claude -c --dangerously-skip-permissions" C-m
+        fi
         tmux attach-session -t claude-code
       else
         echo "Starting a new Claude Code tmux session." | tee -a "$HOME/.claude-code.log"