# u-tabs

TUI 工作空间启动器 — 在终端快速选择项目，一键启动 Claude Code。

## 功能

- YAML 配置驱动，分组管理工作空间
- 左右布局：列表 + 详情面板
- 一键启动 Windows Terminal + Claude Code
- 多选批量启动、编号快捷跳转
- HISTORY Tab：浏览历史会话，一键恢复
- AI 摘要：自动为历史会话生成摘要
- 自动更新：启动检查新版本，`u` 键一键自升级
- 跨平台：Windows / Linux / macOS
- Tokyo Night 主题，CJK 字符安全渲染

## 安装

```bash
# 下载
curl -LO https://c.1216.top/u-tabs/download/u-tabs-linux-amd64
chmod +x u-tabs-linux-amd64 && mv u-tabs-linux-amd64 /usr/local/bin/u-tabs

# 或从源码编译
git clone https://gitea.1216.top/lxy/u-tabs.git
cd u-tabs && go build .
```

Windows 用户下载 [u-tabs-windows-amd64.exe](https://c.1216.top/u-tabs/download/u-tabs-windows-amd64.exe)，重命名为 `u-tabs.exe` 使用。

macOS 用户下载 [darwin-arm64](https://c.1216.top/u-tabs/download/u-tabs-darwin-arm64)（Apple Silicon）或 [darwin-amd64](https://c.1216.top/u-tabs/download/u-tabs-darwin-amd64)（Intel），重命名为 `u-tabs` 后 `chmod +x` 使用。

## 配置

首次运行读取 `~/.u-tabs/config.yaml`，参考 [config.example.yaml](./config.example.yaml)。

```yaml
groups:
  - label: CORE
    desc: 核心业务
    base: 10
    items:
      - title: my-project
        prompt: 项目描述
        tech: Go/Gin
        deploy: 本地开发
        dir: "E:\\projects\\my-project"
```

### 字段说明

**分组 (Group)**

| 字段 | 必填 | 说明 |
|------|------|------|
| `label` | 是 | 分组标识，显示在 Tab 栏（如 CORE、LAB） |
| `desc` | 否 | 分组描述 |
| `base` | 是 | 编号起始值，组内项目编号 = base + 序号（如 base=10，第一个项目编号 10） |

**工作空间 (Item)**

| 字段 | 必填 | 说明 |
|------|------|------|
| `title` | 是 | 项目名称，显示在列表和启动标题 |
| `prompt` | 否 | 项目描述，列表中 title 后显示 |
| `tech` | 否 | 技术栈，详情面板展示 |
| `deploy` | 否 | 部署信息，详情面板展示 |
| `dir` | 是 | 项目目录路径，支持 `~` 展开 |

**配置加载优先级**: `~/.u-tabs/config.yaml` > exe 同目录 `config.yaml`

## 快捷键

### Workspace Tab

| 按键 | 功能 |
|------|------|
| j/k | 上下选择 |
| Tab | 切换分组 |
| Enter | 启动选中项 |
| Space | 多选标记 |
| 0-9 | 编号输入 |
| q | 退出 |

### HISTORY Tab

| 按键 | 功能 |
|------|------|
| j/k | 上下选择 |
| Tab | 左右面板切换 |
| Enter | 恢复会话 |
| n | 新建会话 |
| r/F5 | 刷新扫描 |
| q | 退出 |

**全局**: `u` 更新到新版本（任何 Tab 可用）

## 自动更新

启动时后台检查版本，发现新版本时底部提示 `v{new} available [u]update`。按 `u` 键下载替换并校验 SHA256，失败自动回滚旧版本。更新后重启生效。

## 技术栈

Go 1.26 / Bubbletea v2 / Lipgloss v2