chore(master): release 2.4.0

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.4.0](https://github.com/chenasraf/tx/compare/v2.3.0...v2.4.0) (2026-04-07)
+
+
+### Features
+
+* add background flag ([54fa59b](https://github.com/chenasraf/tx/commit/54fa59be464c226e9da0510b8d2a290023782d4a))
+
+## [2.3.0](https://github.com/chenasraf/tx/compare/v2.2.0...v2.3.0) (2026-04-04)
+
+
+### Features
+
+* ls sessions as table ([7a9ea1b](https://github.com/chenasraf/tx/commit/7a9ea1b41d1fff87cbd160409453502b56dad29d))
+
 ## [2.2.0](https://github.com/chenasraf/tx/compare/v2.1.0...v2.2.0) (2026-03-24)
 
 

README.md

@@ -82,6 +82,11 @@ tx create -S          # save only (don't create)
 tx prj [name]
 tx prj -s             # save to config
 
+# Create session in background (don't switch to it)
+tx -b my-session
+tx create -b
+tx prj -b myproject
+
 # Attach to existing session
 tx attach [name]
 
@@ -98,10 +103,11 @@ tx kill foo bar baz   # kill multiple sessions
 
 ### Global Flags
 
-| Flag            | Description                               |
-| --------------- | ----------------------------------------- |
-| `-v, --verbose` | Verbose logging                           |
-| `-d, --dry`     | Dry run (show commands without executing) |
+| Flag               | Description                                          |
+| ------------------ | ---------------------------------------------------- |
+| `-V, --verbose`    | Verbose logging                                      |
+| `-d, --dry`        | Dry run (show commands without executing)            |
+| `-b, --background` | Create session in background without switching to it |
 
 ---
 
@@ -275,11 +281,11 @@ layout:
 
 #### Split Options
 
-| Setting     | Description                                            |
-| ----------- | ------------------------------------------------------ |
+| Setting     | Description                                                 |
+| ----------- | ----------------------------------------------------------- |
 | `direction` | `h` (horizontal / side-by-side) or `v` (vertical / stacked) |
-| `size`      | Percentage of space for the child pane (1-100, default: 50)  |
-| `child`     | Pane configuration for the new pane created by the split     |
+| `size`      | Percentage of space for the child pane (1-100, default: 50) |
+| `child`     | Pane configuration for the new pane created by the split    |
 
 ### Global Settings
 
@@ -308,8 +314,8 @@ myproject:
 
 #### Default Layout
 
-The `default_layout` setting overrides the built-in default pane arrangement for all windows.
-It accepts the same [pane options](#pane-options) as a regular layout.
+The `default_layout` setting overrides the built-in default pane arrangement for all windows. It
+accepts the same [pane options](#pane-options) as a regular layout.
 
 ```yaml
 .config:
@@ -446,6 +452,9 @@ tx create -r ~/myproject -w src -w lib -w test
 
 # Create and save to config
 tx create -r ~/myproject -s
+
+# Create in background (don't switch to it)
+tx create -b -r ~/myproject
 ```
 
 ### Project Workflow

internal/cli/create_cmd.go

@@ -75,6 +75,10 @@ func runCreate(cmd *cobra.Command, args []string) error {
 
 	// Check if session exists
 	if tmux.SessionExists(opts, parsed.Name) {
+		if background {
+			exec.Log(opts, "Session already exists (background mode, not attaching)")
+			return nil
+		}
 		exec.Log(opts, "Session already exists, attaching")
 		return tmux.AttachToSession(opts, parsed.Name)
 	}
@@ -92,5 +96,5 @@ func runCreate(cmd *cobra.Command, args []string) error {
 	}
 
 	// Create the session
-	return tmux.CreateFromConfig(opts, parsed)
+	return tmux.CreateFromConfig(opts, parsed, background)
 }

internal/cli/list_cmd.go

@@ -2,10 +2,12 @@ package cli
 
 import (
 	"fmt"
+	"regexp"
 	"sort"
 	"strings"
 
 	"github.com/chenasraf/tx/internal/config"
+	"github.com/chenasraf/tx/internal/table"
 	"github.com/chenasraf/tx/internal/tmux"
 	"github.com/spf13/cobra"
 )
@@ -61,13 +63,7 @@ func runList(cmd *cobra.Command, args []string) error {
 	sessionsOutput, err := tmux.ListSessions(opts)
 	sessionsStr := ""
 	if err == nil && sessionsOutput != "" {
-		// Format sessions output
-		lines := strings.Split(strings.TrimSpace(sessionsOutput), "\n")
-		for _, line := range lines {
-			if line != "" {
-				sessionsStr += "  " + line + "\n"
-			}
-		}
+		sessionsStr = formatSessionsTable(sessionsOutput, "  ")
 	} else {
 		sessionsStr = "  No tmux sessions\n"
 	}
@@ -107,3 +103,28 @@ func runList(cmd *cobra.Command, args []string) error {
 
 	return nil
 }
+
+var sessionLineRe = regexp.MustCompile(`^([^:]+):\s*(\d+)\s+windows?\s*\(created\s+([^)]+)\)\s*(.*)$`)
+
+// formatSessionsTable parses `tmux ls` output and renders it as a bordered
+// table with headers. Each output line is prefixed with indent.
+func formatSessionsTable(raw, indent string) string {
+	lines := strings.Split(strings.TrimSpace(raw), "\n")
+	rows := make([][]string, 0, len(lines))
+	for _, line := range lines {
+		if line == "" {
+			continue
+		}
+		m := sessionLineRe.FindStringSubmatch(line)
+		if m == nil {
+			// Fallback: dump the whole line into the Name column
+			rows = append(rows, []string{line, "", "", ""})
+			continue
+		}
+		status := strings.TrimSpace(m[4])
+		status = strings.TrimPrefix(status, "(")
+		status = strings.TrimSuffix(status, ")")
+		rows = append(rows, []string{m[1], m[2], m[3], status})
+	}
+	return table.Render([]string{"Name", "Windows", "Created", "Status"}, rows, indent)
+}

internal/cli/main_cmd.go

@@ -53,10 +53,14 @@ func runMain(cmd *cobra.Command, args []string) error {
 
 	// Check if session exists
 	if tmux.SessionExists(opts, parsed.Name) {
+		if background {
+			exec.Log(opts, "Session exists (background mode, not attaching)")
+			return nil
+		}
 		exec.Log(opts, "Session exists, attaching...")
 		return tmux.AttachToSession(opts, parsed.Name)
 	}
 
 	// Create session
-	return tmux.CreateFromConfig(opts, parsed)
+	return tmux.CreateFromConfig(opts, parsed, background)
 }

internal/cli/prj_cmd.go

@@ -119,7 +119,7 @@ func runPrj(cmd *cobra.Command, args []string) error {
 	}
 
 	// Create session
-	return tmux.CreateFromConfig(opts, parsed)
+	return tmux.CreateFromConfig(opts, parsed, background)
 }
 
 // getProjects returns directory names in the given path

internal/cli/root.go

@@ -16,8 +16,9 @@ var (
 	Version string
 
 	// Global flags
-	verbose bool
-	dry     bool
+	verbose    bool
+	dry        bool
+	background bool
 )
 
 // GetOpts returns the current execution options
@@ -166,6 +167,7 @@ func init() {
 	// Global flags
 	rootCmd.PersistentFlags().BoolVarP(&verbose, "verbose", "V", false, "Verbose logging")
 	rootCmd.PersistentFlags().BoolVarP(&dry, "dry", "d", false, "Dry run (log commands, don't execute)")
+	rootCmd.PersistentFlags().BoolVarP(&background, "background", "b", false, "Create session in background without attaching")
 	rootCmd.Flags().BoolP("version", "v", false, "Print version")
 
 	// Add subcommands

internal/table/table.go

@@ -0,0 +1,57 @@
+// Package table renders simple bordered text tables with headers.
+package table
+
+import (
+	"strings"
+	"unicode/utf8"
+)
+
+// Render returns a bordered table string with the given headers and rows.
+// Every line in the output is prefixed with indent. Column widths auto-size
+// to the widest cell (header included).
+func Render(headers []string, rows [][]string, indent string) string {
+	widths := make([]int, len(headers))
+	for i, h := range headers {
+		widths[i] = utf8.RuneCountInString(h)
+	}
+	for _, row := range rows {
+		for i, cell := range row {
+			if i >= len(widths) {
+				break
+			}
+			if w := utf8.RuneCountInString(cell); w > widths[i] {
+				widths[i] = w
+			}
+		}
+	}
+
+	border := func(left, mid, right string) string {
+		parts := make([]string, len(widths))
+		for i, w := range widths {
+			parts[i] = strings.Repeat("─", w+2)
+		}
+		return left + strings.Join(parts, mid) + right
+	}
+	rowLine := func(cells []string) string {
+		parts := make([]string, len(widths))
+		for i := range widths {
+			cell := ""
+			if i < len(cells) {
+				cell = cells[i]
+			}
+			pad := max(widths[i]-utf8.RuneCountInString(cell), 0)
+			parts[i] = " " + cell + strings.Repeat(" ", pad) + " "
+		}
+		return "│" + strings.Join(parts, "│") + "│"
+	}
+
+	var b strings.Builder
+	b.WriteString(indent + border("┌", "┬", "┐") + "\n")
+	b.WriteString(indent + rowLine(headers) + "\n")
+	b.WriteString(indent + border("├", "┼", "┤") + "\n")
+	for _, row := range rows {
+		b.WriteString(indent + rowLine(row) + "\n")
+	}
+	b.WriteString(indent + border("└", "┴", "┘") + "\n")
+	return b.String()
+}

internal/tmux/builder.go

@@ -8,8 +8,9 @@ import (
 	"github.com/chenasraf/tx/internal/exec"
 )
 
-// CreateFromConfig creates a tmux session from a parsed config
-func CreateFromConfig(opts exec.Opts, tmuxConfig config.ParsedTmuxConfigItem) error {
+// CreateFromConfig creates a tmux session from a parsed config.
+// If background is true, the session is created but not attached to.
+func CreateFromConfig(opts exec.Opts, tmuxConfig config.ParsedTmuxConfigItem, background bool) error {
 	root := tmuxConfig.Root
 	windows := tmuxConfig.Windows
 	sessionName := config.NameFix(tmuxConfig.Name)
@@ -19,6 +20,10 @@ func CreateFromConfig(opts exec.Opts, tmuxConfig config.ParsedTmuxConfigItem) er
 
 	// Check if session already exists
 	if SessionExists(opts, sessionName) {
+		if background {
+			exec.Log(opts, fmt.Sprintf("tmux session %s already exists (background mode, not attaching)", sessionName))
+			return nil
+		}
 		exec.Log(opts, fmt.Sprintf("tmux session %s already exists, attaching...", sessionName))
 		return AttachToSession(opts, sessionName)
 	}
@@ -73,7 +78,10 @@ func CreateFromConfig(opts exec.Opts, tmuxConfig config.ParsedTmuxConfigItem) er
 		}
 	}
 
-	// Attach to the session
+	// Attach to the session unless background mode
+	if background {
+		return nil
+	}
 	return AttachToSession(opts, sessionName)
 }
 

internal/tmux/builder_test.go

@@ -251,7 +251,7 @@ func TestCreateFromConfig_DryRun(t *testing.T) {
 	}
 
 	// In dry mode, this should succeed without actually running tmux
-	err := CreateFromConfig(opts, tmuxConfig)
+	err := CreateFromConfig(opts, tmuxConfig, false)
 	if err != nil {
 		t.Errorf("expected no error in dry mode, got %v", err)
 	}
@@ -281,7 +281,7 @@ func TestCreateFromConfig_MultipleWindows(t *testing.T) {
 		},
 	}
 
-	err := CreateFromConfig(opts, tmuxConfig)
+	err := CreateFromConfig(opts, tmuxConfig, false)
 	if err != nil {
 		t.Errorf("expected no error in dry mode, got %v", err)
 	}

version.txt

@@ -1 +1 @@
-2.2.0
+2.4.0