ds creates tmux dev sessions locally or on remote hosts. Profiles, connection methods, and share backends are all pluggable.

curl -sL https://raw.githubusercontent.com/cgraf78/ds/main/install.sh | bash

Or from source:

git clone https://github.com/cgraf78/ds.git
cd ds && bash install.sh

ds                              # default session "ds" (plain tmux)
ds dev                          # session "dev" with dev profile
ds dev-work                     # session "dev-work" with dev profile
ds chat                         # session "chat" with chat profile

ds dev @myhost                  # dev session on remote host
ds @myhost                      # default session on remote host

ds -l                           # list active ds sessions
ds -l @myhost                   # list sessions on remote host

ds -k dev                       # kill session "dev"
ds -k                           # kill current session (inside tmux)
ds --killall                    # kill all ds sessions

ds --share                      # share current session via upterm
ds --share dev                  # share session "dev"
ds --unshare                    # stop sharing
ds --share-via upterm           # create/attach and share in one step

ds init bash                    # print shell integration snippet

Sessions are named after their profile, with an optional dash-separated instance tag:

The profile is resolved from the session name: split on the first -, and if the left side matches a known profile, that profile is used. Profile names must not contain dashes.

Profiles define the tmux window/pane layout. Bundled profiles live in lib/plugins/. User profiles go in ~/.config/ds/profile-<name>.sh (user config takes priority).

Each profile defines a _profile_<name>() function:

# ~/.config/ds/profile-myprofile.sh
_profile_myprofile() {
    local session="$1"
    # set up tmux windows/panes here
}

dev — chatbot pane (top) + bash (bottom) + separate bash window.

chat — single window running a chatbot.

All ~/.config/ds/connect*.conf files are read (additive). Format: two columns — hostname (glob patterns supported) and connect method. First match wins.

# ~/.config/ds/connect.conf
myserver      autossh
dev*          ssh
localbox      -

See examples/connect.conf for a template.

ssh is built-in. Other methods are plugins in ~/.config/ds/connect-<method>.sh (or bundled in lib/plugins/), defining _connect_<method>().

Share backends live in lib/plugins/share-<backend>.sh or ~/.config/ds/share-<backend>.sh. Config goes in ~/.config/ds/share-<backend>.conf.

Only one session can be shared at a time. ds -l marks shared sessions with [shared].

Config file: ~/.config/ds/share-upterm.conf (env vars DS_UPTERM_* override):

See examples/share-upterm.conf for a template.

Add to ~/.bashrc:

eval "$(ds init bash)"

This provides tab completion and ET connect support.

Set DS_SSH_AUTO_ATTACH before the eval line to auto-create/attach a tmux session on SSH login:

DS_SSH_AUTO_ATTACH=ds         # attach to default "ds" session
# DS_SSH_AUTO_ATTACH=dev      # attach to "dev" session instead
eval "$(ds init bash)"

Skip auto-attach for a single login with NO_TMUX=1.

Runtime state lives under ~/.local/state/ds/ (mode 0700).

MIT — see LICENSE.