session-manager/config.example at main · parallelworks/session-manager · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
# Session Manager Configuration
# Copy this file to ~/.config/session-manager/config and update with your values

# =============================================================================
# SSH Configuration
# =============================================================================

# Path to SSH config file (default: ~/.ssh/config)
# export SESSION_MANAGER_SSH_CONFIG="$HOME/.ssh/config"

# =============================================================================
# Remote Session Configuration
# =============================================================================

# Command to run on remote systems (default: bash)
# Examples:
#   export SESSION_MANAGER_REMOTE_CMD="bash"        # Default shell
#   export SESSION_MANAGER_REMOTE_CMD="agent-deck"  # AgentDeck
#   export SESSION_MANAGER_REMOTE_CMD="htop"        # System monitor
#   export SESSION_MANAGER_REMOTE_CMD="nvim"        # Neovim editor

# export SESSION_MANAGER_REMOTE_CMD="bash"

# Default remote working directory (default: ~)
# export SESSION_MANAGER_REMOTE_DIR="~"

# =============================================================================
# Local Session Configuration
# =============================================================================

# Default local app for 'sm local' (no args) and 'sm .' commands
# This lets you quickly launch your preferred app without specifying it
# Available apps: bash, opencode, claude, agent-deck
# Examples:
#   export SESSION_MANAGER_LOCAL_APP="claude"       # Claude Code CLI
#   export SESSION_MANAGER_LOCAL_APP="agent-deck"   # AgentDeck
#   export SESSION_MANAGER_LOCAL_APP="bash"         # Basic shell

# export SESSION_MANAGER_LOCAL_APP="agent-deck"

# =============================================================================
# Display Configuration
# =============================================================================

# Automatically enter fullscreen mode when attaching to sessions (macOS only)
# Set to "true" to enable fullscreen mode when sessions are attached
# export SESSION_MANAGER_FULLSCREEN="true"

# =============================================================================
# Quick Start
# =============================================================================
#
# 1. Add hosts to your SSH config (~/.ssh/config):
#
#    Host devserver
#        Hostname 192.168.1.100
#        User myuser
#        IdentityFile ~/.ssh/id_rsa
#
#    Host prodbox
#        Hostname prod.example.com
#        User deploy
#        Port 2222
#
# 2. Run session-manager:
#
#    sm hosts              # See available hosts
#    sm devserver          # Connect to devserver
#    sm status             # View all sessions
#
# 3. Local sessions (if SESSION_MANAGER_LOCAL_APP is set):
#
#    sm .                  # Quick start default app in current dir
#    sm local              # Start default local app
#    sm local claude       # Start specific app
#
# =============================================================================
# How It Works
# =============================================================================
#
# When you run `sm devserver`:
#   1. Creates local tmux session "remote-devserver"
#   2. SSHs to devserver
#   3. Creates remote tmux session "devserver"
#   4. Runs your configured command inside remote tmux
#
# This means your session keeps running even if SSH disconnects.
# Reconnecting (`sm devserver`) reattaches to the same session.
#
# To detach: Ctrl+B, then D