v0.1.4

prevent orphaned tmux -C subprocesses on abnormal consumer exit

previously the control transport spawned a long-lived tmux -C attach-session child that was reliably killed only by an explicit (*Tmux).Close(). a consumer that exited without Close — crash, signal, or a short-lived subcommand — orphaned the child, leaving it attached to the tmux server until the server died. in practice this showed up as dozens of accumulated orphans saturating the single-threaded tmux server.

fixes

• add build-tagged sysProcAttr() helpers applied to the spawned command: linux sets Pdeathsig: SIGKILL (the kernel reaps the child on parent death) plus Setpgid; darwin/bsd set Setpgid only, since there is no pdeathsig equivalent; non-unix returns nil (440c9d0)
• derive an internal cancelable lifetime context in New, cancelled by Close() and on child exit, giving a second CommandContext-based kill path independent of Process.Kill (440c9d0)

additions

• expose NewTmuxContext(ctx, socket, ...) so consumers can bind a client's lifetime to e.g. signal.NotifyContext (440c9d0)

notes

• calling Close() remains mandatory on macOS/bsd, where there is no parent-death signal to fall back on

tests

• platform helper coverage (Setpgid everywhere, Pdeathsig on linux)
• that New wires SysProcAttr onto the command
• that NewTmuxContext threads its context through to the dialer

upgrading

go get github.com/atomicstack/gotmuxcc@v0.1.4

v0.1.3

exact session-id targeting in session helpers

this patch release makes session-scoped operations target tmux sessions by id rather than by name, so overlapping session names can no longer be resolved via tmux prefix matching.

fixes

• prefer session ids over session names when issuing tmux commands from Session helpers, using an id-first target helper that falls back to Name for manually constructed Session values without an Id (38536dc)
• refresh Session.Name after a successful Rename so follow-on operations do not depend on stale local state (38536dc)

tests

• unit coverage for id-first targeting and the name fallback path
• an integration test reproducing the reported claude / claude2 name collision, verifying only the intended session is removed

upgrading

go get github.com/atomicstack/gotmuxcc@v0.1.3

v0.1.2

Security hardening for control-mode protocol

This patch release hardens the tmux control-mode protocol layer against injection attacks.

Changes

• Harden control-mode protocol against newline injection — reject or sanitize inputs containing newline characters that could break the control-mode framing protocol (43c5cdc)
• Add format string quoting and security regression tests — quote tmux format strings to prevent interpretation of user-controlled data as format variables, with regression tests covering injection vectors (97db0a6)
• Harden control-mode protocol against injection — additional hardening across the protocol layer to prevent command injection via crafted session/window/pane names (91bf5db)

Maintenance

• Add .worktrees/ to .gitignore (e97ef58)

Upgrading

go get github.com/atomicstack/gotmuxcc@v0.1.2

v0.1.1

empty-server control-mode startup fix

this release fixes a constructor bug in gotmuxcc.NewTmux() / NewTmuxWithOptions() when connecting to a tmux server that has no existing sessions.

previously, gotmuxcc could fall through to bare tmux -C during startup. tmux interprets that as an implicit new-session, which created an unwanted session as a side effect of opening the control-mode connection.

fixes

• use an explicit startup plan instead of falling through to bare tmux -C
• attach to an existing session when one is available
• when no sessions exist, create a uniquely named detached bootstrap session instead of consuming the next numeric session name such as 0
• propagate unexpected list-sessions discovery failures as constructor errors instead of silently treating them as "no sessions"
• clean up the bootstrap session with a best-effort kill-session when the Tmux handle is closed

tests

• added unit coverage for existing-session startup
• added unit coverage for empty-server bootstrap startup
• added unit coverage for discovery error propagation
• added unit coverage for bootstrap-session cleanup on Close()

caveat

if a caller keeps a Tmux handle open while the server still has no real user sessions, the named bootstrap session may remain visible until Close() is called. this avoids stealing the first numeric session name and keeps the control-mode client alive, but it is not yet an immediate auto-retirement of the bootstrap session.

commit

• 9111a04 fix: avoid phantom tmux sessions on empty servers

v0.1.0

target-string APIs and missing surfaces

this release adds target-string methods and option struct extensions so
consumers can create and manipulate sessions, windows, and panes by tmux target
string (e.g. "mysession:2", "mysession:2.1") without needing materialized
Go objects. this is particularly useful for bulk session restore workflows.

new methods

• Tmux.SplitWindow(target, opts) — split a pane by target string,
  with optional direction, start directory, detached mode, and startup command
• Tmux.SelectLayout(target, layout) — apply a layout string (including
  custom checksum layouts) to a window by target string
• Tmux.GlobalOption(key) — query server-level global options via
  show-option -gqv; returns empty string for unset options

extended option structs

• NewWindowOptions — added Index *int (target a specific window index)
  and ShellCommand string (startup command as last positional arg)
• SplitWindowOptions — added Detached bool (-d flag to keep focus on
  current pane)

notes

• Tmux.SelectPane(target) and Tmux.SelectWindow(target) were already
  available since v0.0.1
• SessionOptions.ShellCommand already supported startup commands for
  new-session since v0.0.1
• no breaking changes — all existing APIs are unchanged

commits

• e429228 feat: add Index and ShellCommand fields to NewWindowOptions
• 7a1ce5f feat: add Detached to SplitWindowOptions; add Tmux.SplitWindow()
• ffbb3c9 feat: add Tmux.GlobalOption() for server-level option queries
• 0738282 feat: add Tmux.SelectLayout() for target-based layout selection