Serie

Serie：终端里的富 Git 提交图

Serie 是一款用 Rust 编写的 TUI 工具，目标是在终端中提供比 git log --graph --all 更易读的提交图体验。它利用终端模拟器的图像显示协议，把提交历史渲染成真正的图形，而不是字符拼出的线条。

核心特性

• 图像化提交图：分支、合并与分叉以图形方式呈现，支持圆角、折角、曲线等边线风格，并可开启抗锯齿。
• 以提交图为中心的浏览：围绕提交图查看提交详情、引用（分支/标签）和 Diff。
• 搜索与筛选：在提交历史中快速定位目标提交。
• 用户自定义命令：可把 git diff 等命令的输出放到独立视图，也可后台执行分支删除，或挂起应用运行 vim 等交互命令。
• 可配置：通过 config.toml 调整行为，并支持覆盖默认快捷键。

安装与使用

使用 Cargo 安装：

cargo install --locked serie

在 Git 仓库目录下直接运行：

cd <your-git-repository>
serie

常用参数包括 --max-count 限制渲染提交数、--protocol 指定图像协议、--order 选择提交排序算法，以及 --primary-branch 将主分支固定在左侧列。

终端兼容性

Serie 依赖终端图像协议，目前支持 iTerm2 的内联图像协议和 kitty 的图形协议（含 Unicode 占位符模式）。tmux 仅在 kitty Unicode 占位符模式下可用；Sixel 与其他终端复用器不受支持，Windows 也未获官方支持。使用前建议先确认自己的终端环境。

适合谁

如果你习惯在终端里工作，又觉得 git log --graph 难以阅读，Serie 提供了一个轻量、专注日志浏览的折中方案——它不试图成为完整的 Git 客户端，而是把提交图这一件事做得足够好。