feat: tmux module

[35C4n0r]

Closes #203
/claim #203

Description

Introduce the tmux module

Demo

https://www.loom.com/share/ec8169d34c3043f7af2163b1a1a14a4b?sid=1ea8bcb2-3db0-43ca-965a-5ed42eec3448

Type of Change

• New module
• Bug fix
• Feature/enhancement
• Documentation
• Other

Module Information

Path: registry/anomaly/modules/tmux
New version: v1.0.0
Breaking change: [ ] Yes [x] No

Testing & Validation

• Tests pass (bun test)
• Code formatted (bun run fmt)
• Changes tested locally

Related Issues

#203

[35C4n0r]

@matifali please review.

[35C4n0r]

@DevelopmentCats let me know if this needs any changes :)

[35C4n0r]

My bad, added frontmatter.
Can you approve the CI run again.

[bpmct]

Hey - We should have clarified this in the issue, but the ability to pre-define sessions in the module via variables, then them to show up as coder_app would be the key reason I see people use this.

[35C4n0r]

@bpmct

pre-define sessions in the module via variables

Doable 👍🏻 (1 module/session, is that what we want ?)

then them to show up as coder_app

Ok, so it will show up in the UI as a button and then we redirect them to existing terminal and start the tmux server with that session ? Can you explain the expected flow.

[bpmct]

@bpmct

pre-define sessions in the module via variables

Doable 👍🏻 (1 module/session, is that what we want ?)

then them to show up as coder_app

Ok, so it will show up in the UI as a button and then we redirect them to existing terminal and start the tmux server with that session ? Can you explain the expected flow.

Yes. We used to do this in the claude code module. here is an example:

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

Lines 232 to 267 in 8e051a8

	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"
	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
	}