# tmux.bash

**Repository Path**: codingbelief/tmux.bash

## Basic Information

- **Project Name**: tmux.bash
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-03
- **Last Updated**: 2026-01-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tmux 配置

这是一个包含别名和自动补全功能的 tmux 配置集合。

## 功能特性

- 🚀 **快捷别名**：简化 tmux 常用操作
- 🔧 **自动补全**：支持 Tab 键智能补全 sessions 和命令
- 💡 **提示符增强**：在 tmux 中显示 [session:window] 信息
- 📦 **自动安装**：支持 Ubuntu/Debian 和 macOS 系统
- 🔄 **幂等安装**：重复运行安装脚本不会重复添加配置

## 快速开始

### 方式一：使用 Git Clone（推荐）

```bash
# 克隆仓库到 ~/.tmux 目录
git clone https://gitee.com/codingbelief/tmux.bash.git ~/.tmux

# 运行安装脚本
cd ~/.tmux
bash install.sh
```

### 方式二：手动下载

1. **下载并解压文件到 ~/.tmux 目录**

```bash
mkdir -p ~/.tmux
# 将下载的文件复制到 ~/.tmux 目录
```

2. **运行安装脚本**

```bash
cd ~/.tmux
bash install.sh
```

### 安装脚本功能

安装脚本会自动：
1. 检测系统并安装 tmux（如果未安装）
   - Ubuntu/Debian: 使用 `apt-get` 安装
   - macOS: 使用 `brew` 安装
2. 将配置添加到 `~/.bashrc`（如果未添加）
3. 显示安装完成后的使用说明

### 手动安装（不推荐）

如果你想手动配置而不使用安装脚本：

**只需在 `~/.bashrc` 中添加一行：**

```bash
# tmux 配置
if [ -f ~/.tmux/settings.bash ]; then
    . ~/.tmux/settings.bash
fi
```

然后重新加载配置：

```bash
source ~/.bashrc
```

**注意**：`settings.bash` 会自动加载所有配置文件（别名、补全、提示符等）。

## 可用命令

### 别名

| 命令 | 说明 | 示例 |
|------|------|------|
| `tma` | 连接到已存在的 tmux session | `tma session_name` |
| `tml` | 列出所有 tmux sessions | `tml` |
| `tmn` | 创建新的 tmux session | `tmn session_name` |

### 使用示例

```bash
# 列出所有 sessions
tml

# 连接到名为 "work" 的 session（支持 Tab 补全）
tma wo<Tab>  # 自动补全为 work

# 创建新 session
tmn myproject

# 使用 tmux 原生命令（也支持补全）
tmux new<Tab>        # 补全为 new-session
tmux attach<Tab>     # 补全 attach 相关命令和 sessions
```

## 提示符增强

当你在 tmux 会话中时，提示符会自动在前面显示当前的 session 和 window 编号：

```
[myproject:1] user@hostname ~$
```

- **myproject** - 当前 session 名称
- **1** - 当前 window 编号

这样你可以清楚地知道自己在哪个 tmux 会话和窗口中工作。

**注意**：此功能仅在 tmux 会话内启用，退出 tmux 后提示符恢复正常。

## 自动补全

### 支持的补全

1. **tmux 主命令补全**
   - 所有 tmux 子命令（包括简写形式）
   - 根据子命令智能补全参数

2. **别名命令补全**
   - `tma` - 补全现有 sessions
   - `tmn` - 补全命令选项（-s, -t, -n, -d）

### 补全示例

```bash
# 补全 tmux 子命令
tmux ne<Tab>          # 补全为 new, new-session 等

# 补全 session 名称
tma <Tab>             # 显示所有可用 sessions
tmux attach <Tab>     # 显示所有可连接的 sessions

# 补全选项
tmn -<Tab>            # 显示可用选项 (-s, -t, -n, -d)
```

## 系统要求

- **操作系统**：Ubuntu/Debian 或 macOS
- **Shell**：Bash
- **依赖**：tmux 2.0+

## 手动安装 tmux

如果自动安装失败，可以手动安装 tmux：

### Ubuntu/Debian

```bash
sudo apt-get update
sudo apt-get install tmux
```

### macOS

```bash
brew install tmux
```

## 文件结构

```
~/.tmux/
├── README.md           # 说明文档
├── install.sh          # 自动安装脚本
├── settings.bash       # 主配置入口（加载其他所有配置）
├── alias.bash          # tmux 别名定义
├── completion.bash     # bash 自动补全脚本
└── ps.bash            # 提示符增强（显示 session:window）
```

## 卸载

1. 从 `~/.bashrc` 中删除 tmux 配置段

```bash
# 删除以下内容：
# tmux 配置
if [ -f ~/.tmux/completion.bash ]; then
    . ~/.tmux/completion.bash
fi
if [ -f ~/.tmux/alias.bash ]; then
    . ~/.tmux/alias.bash
fi
```

2. 删除配置文件（可选）

```bash
rm -rf ~/.tmux
```

3. 重新加载配置

```bash
source ~/.bashrc
```

## 常见问题

### Q: Tab 补全不工作？

A: 确保 bash-completion 已安装并启用：

```bash
# Ubuntu/Debian
sudo apt-get install bash-completion

# macOS
brew install bash-completion
```

### Q: 别名不生效？

A: 重新加载配置：

```bash
source ~/.bashrc
```

### Q: 如何查看所有 tmux sessions？

A: 使用 `tml` 命令或 `tmux ls`

## 贡献

欢迎提交 Issue 和 Pull Request！

## 许可证

MIT License