hosttmux

Documentation

Overview

Package hosttmux materializes the tmux config Dejima applies to the host terminals it creates (operator shells running in tmux ON the daemon host).

In-container agent sessions get their tmux defaults from the image's /etc/tmux.conf (see image/tmux.conf). Host terminals run on the daemon host where there is no such system config and where the operator may already keep a ~/.tmux.conf we must not clobber. So instead of touching the user's config we ship a dedicated config and pass it to ONLY Dejima-created host sessions via `tmux -f`; that config first `source-file`s the user's ~/.tmux.conf and then layers Dejima's passthrough/extended-keys defaults on top.

Index

• func ConfigPath() (string, error)
• func NewSessionArgs(rest ...string) []string

Functions

func ConfigPath

func ConfigPath() (string, error)

ConfigPath writes the embedded host-tmux config to ~/.dejima/tmux-host.conf (refreshing it if the embedded content changed) and returns the path, for use as the argument to `tmux -f`. It is cheap and idempotent: callers invoke it on every host session create/attach so a daemon upgrade re-materializes the latest config without any install step.

func NewSessionArgs

func NewSessionArgs(rest ...string) []string

NewSessionArgs returns the leading `tmux -f <config> …` argv for a host tmux command, so host session create/attach share one passthrough-enabled config. On failure to materialize the config it falls back to a bare `tmux` so host terminals never break just because the config could not be written.