t/t.1 at master · magicdrive/t · 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
91
92
93
94
95
.\" t(1) - Lazy tmux wrapper
.TH t 1 "2025-07-02" "v1.1.0" "User Commands"
.SH NAME
t \- A lazy, powerful tmux session wrapper

.SH SYNOPSIS
.B t
[\fIOPTIONS\fR] [\fIsession_name\fR] [\fITMUX_OPTIONS\fR]

.SH DESCRIPTION
.PP
.B t
is a minimal wrapper for tmux session management.
It allows you to create, attach, detach, and list tmux sessions with intuitive commands.

.SH OPTIONS
.TP
.B -A, -a, --attach
Attach to (or create) a session \fBwithout\fR detaching other clients. Takes an optional \fIsession_name\fR.
.TP
.B --ad, --attach-with-detach
Attach to (or create) a session \fBand\fR detach other clients (default behavior). Takes an optional \fIsession_name\fR.
.TP
.B -S, -s, --sock \fISOCKET_PATH\fR
Use a custom tmux socket file.
.TP
.B -l, --list [session|window]
List all active tmux sessions or windows.
.TP
.B -k, --kill \fIsession_name\fR
Kill the specified session (default: current).
.TP
.B -f, --prefix \fIkey\fR
Rebind the tmux prefix-key (e.g. 'a', 'q').
.TP
.B -d, --detach
Detach from the current session.
.TP
.B -m, --mouse
Toggle mouse mode on or off.
.TP
.B -h, --help
Show this help message and exit.

.SH ENVIRONMENT VARIABLES
.TP
.B T_DEFAULT_SESSIONNAME
Default session name. (default: \fImain\fR)
.TP
.B T_DEFAULT_SOCKPATH
Default tmux socket path. (default: \fI~/tmp/tmux-socket\fR)
.TP
.B T_DEFAULT_TMUX_OPTION
Default tmux command options.
.TP
.B T_DEFAULT_TMUX_ATTACH_WITH_DETACH
Whether to detach other clients by default (default: "on").

.SH EXAMPLES
.PP
Attach or create a session called "dev":
.RS
.B t dev
.RE
.PP
Attach without detaching other clients:
.RS
.B t -a dev
.RE
.PP
List all sessions:
.RS
.B t --list session
.RE
.PP
Kill the "dev" session:
.RS
.B t --kill dev
.RE
.PP
Rebind tmux prefix to 'a':
.RS
.B t --prefix a
.RE

.SH SEE ALSO
tmux(1)

.SH AUTHOR
Copyright (c) 2015–2025 Hiroshi IKEGAMI
Released under the MIT License.

.SH OSS STYLE
This software is open source, intended for hackers, creators, and anyone who loves fast and minimal workflow.
For more information, see: \fIhttps://github.com/magicdrive/t\fR