e5ccf74ccc
## Description Add Tmux Plugin Manager with resurrect and continuum plugins. Add functionality to be able to enable workspace persistence to save the tmux session automatically so that it can persist through workspace restarts. --- ## Type of Change - [ ] New module - [ ] Bug fix - [X] Feature/enhancement - [ ] Documentation - [ ] Other --- ## Module Information **Path:** `registry/coder/modules/claude-code` **New version:** `v1.4.0` **Breaking change:** [ ] Yes [X] No --- ## Testing & Validation - [X] Tests pass (`bun test`) - [X] Code formatted (`bun run fmt`) - [X] Changes tested locally --- ## Related Issues Closes [#29](https://github.com/coder/registry/issues/29)
355 lines
12 KiB
HCL
355 lines
12 KiB
HCL
terraform {
|
|
required_version = ">= 1.0"
|
|
|
|
required_providers {
|
|
coder = {
|
|
source = "coder/coder"
|
|
version = ">= 2.5"
|
|
}
|
|
}
|
|
}
|
|
|
|
variable "agent_id" {
|
|
type = string
|
|
description = "The ID of a Coder agent."
|
|
}
|
|
|
|
data "coder_workspace" "me" {}
|
|
|
|
data "coder_workspace_owner" "me" {}
|
|
|
|
variable "order" {
|
|
type = number
|
|
description = "The order determines the position of app in the UI presentation. The lowest order is shown first and apps with equal order are sorted by name (ascending order)."
|
|
default = null
|
|
}
|
|
|
|
variable "group" {
|
|
type = string
|
|
description = "The name of a group that this app belongs to."
|
|
default = null
|
|
}
|
|
|
|
variable "icon" {
|
|
type = string
|
|
description = "The icon to use for the app."
|
|
default = "/icon/claude.svg"
|
|
}
|
|
|
|
variable "folder" {
|
|
type = string
|
|
description = "The folder to run Claude Code in."
|
|
default = "/home/coder"
|
|
}
|
|
|
|
variable "install_claude_code" {
|
|
type = bool
|
|
description = "Whether to install Claude Code."
|
|
default = true
|
|
}
|
|
|
|
variable "claude_code_version" {
|
|
type = string
|
|
description = "The version of Claude Code to install."
|
|
default = "latest"
|
|
}
|
|
|
|
variable "experiment_use_screen" {
|
|
type = bool
|
|
description = "Whether to use screen for running Claude Code in the background."
|
|
default = false
|
|
}
|
|
|
|
variable "experiment_use_tmux" {
|
|
type = bool
|
|
description = "Whether to use tmux instead of screen for running Claude Code in the background."
|
|
default = false
|
|
}
|
|
|
|
variable "experiment_report_tasks" {
|
|
type = bool
|
|
description = "Whether to enable task reporting."
|
|
default = false
|
|
}
|
|
|
|
variable "experiment_pre_install_script" {
|
|
type = string
|
|
description = "Custom script to run before installing Claude Code."
|
|
default = null
|
|
}
|
|
|
|
variable "experiment_post_install_script" {
|
|
type = string
|
|
description = "Custom script to run after installing Claude Code."
|
|
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) : ""
|
|
}
|
|
|
|
# Install and Initialize Claude Code
|
|
resource "coder_script" "claude_code" {
|
|
agent_id = var.agent_id
|
|
display_name = "Claude Code"
|
|
icon = var.icon
|
|
script = <<-EOT
|
|
#!/bin/bash
|
|
set -e
|
|
|
|
command_exists() {
|
|
command -v "$1" >/dev/null 2>&1
|
|
}
|
|
|
|
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..."
|
|
# The folder must exist before tmux is started or else claude will start
|
|
# in the home directory.
|
|
mkdir -p "${var.folder}"
|
|
echo "Folder created successfully."
|
|
fi
|
|
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
|
|
|
|
if [ "${var.install_claude_code}" = "true" ]; then
|
|
if ! command_exists npm; then
|
|
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}
|
|
fi
|
|
|
|
if [ "${var.experiment_report_tasks}" = "true" ]; then
|
|
echo "Configuring Claude Code to report tasks via Coder MCP..."
|
|
coder exp mcp configure claude-code ${var.folder}
|
|
fi
|
|
|
|
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
|
|
|
|
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
|
|
|
|
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
|
|
|
|
if [ "${var.experiment_use_tmux}" = "true" ]; then
|
|
if ! command_exists tmux; then
|
|
install_tmux
|
|
fi
|
|
|
|
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
|
|
|
|
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
|
|
|
|
if [ "${var.experiment_use_screen}" = "true" ]; then
|
|
echo "Running Claude Code in the background..."
|
|
if ! command_exists screen; then
|
|
echo "Error: screen is not installed. Please install screen manually."
|
|
exit 1
|
|
fi
|
|
|
|
touch "$HOME/.claude-code.log"
|
|
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"
|
|
fi
|
|
|
|
if ! grep -q "^multiuser on$" "$HOME/.screenrc"; then
|
|
echo "Adding 'multiuser on' to ~/.screenrc..." | tee -a "$HOME/.claude-code.log"
|
|
echo "multiuser on" >> "$HOME/.screenrc"
|
|
fi
|
|
|
|
if ! grep -q "^acladd $(whoami)$" "$HOME/.screenrc"; then
|
|
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
|
|
|
|
screen -U -dmS claude-code bash -c '
|
|
cd ${var.folder}
|
|
claude --dangerously-skip-permissions "$CODER_MCP_CLAUDE_TASK_PROMPT" | tee -a "$HOME/.claude-code.log"
|
|
exec bash
|
|
'
|
|
else
|
|
if ! command_exists claude; then
|
|
echo "Error: Claude Code is not installed. Please enable install_claude_code or install it manually."
|
|
exit 1
|
|
fi
|
|
fi
|
|
EOT
|
|
run_on_start = true
|
|
}
|
|
|
|
resource "coder_app" "claude_code" {
|
|
slug = "claude-code"
|
|
display_name = "Claude Code"
|
|
agent_id = var.agent_id
|
|
command = <<-EOT
|
|
#!/bin/bash
|
|
set -e
|
|
|
|
export LANG=en_US.UTF-8
|
|
export LC_ALL=en_US.UTF-8
|
|
|
|
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"
|
|
tmux new-session -s claude-code -c ${var.folder} "claude --dangerously-skip-permissions | tee -a \"$HOME/.claude-code.log\"; exec bash"
|
|
fi
|
|
elif [ "${var.experiment_use_screen}" = "true" ]; then
|
|
if screen -list | grep -q "claude-code"; then
|
|
echo "Attaching to existing Claude Code screen session." | tee -a "$HOME/.claude-code.log"
|
|
screen -xRR claude-code
|
|
else
|
|
echo "Starting a new Claude Code screen session." | tee -a "$HOME/.claude-code.log"
|
|
screen -S claude-code bash -c 'claude --dangerously-skip-permissions | tee -a "$HOME/.claude-code.log"; exec bash'
|
|
fi
|
|
else
|
|
cd ${var.folder}
|
|
claude
|
|
fi
|
|
EOT
|
|
icon = var.icon
|
|
order = var.order
|
|
group = var.group
|
|
}
|