@wekisas/git-tui
v1.0.1
Published
A visual Git TUI tool for terminal - stage, commit, push, stash, branch, repo management
Maintainers
Readme
git-tui
一个终端可视化 Git TUI 工具,支持暂存 / 提交推送、提交历史管理、Stash 管理、GitHub/Gitee 仓库创建与远程连接。

安装
# 全局安装
npm install -g @wekisas/git-tui
# 或本地安装后 link
npm link使用
在任意 Git 项目目录下运行:
gitui功能
Stage(暂存)
- 查看已暂存 / 未暂存文件列表
- 使用
↑↓导航,Enter选择文件 s暂存选中文件,u取消暂存c提交并推送到远程r刷新文件状态
Log(提交历史)
- 查看最近 30 条提交记录
↑↓导航,Enter对选中提交执行操作- 支持 Revert(创建撤销提交)、Soft Reset、Hard Reset
Stash(暂存管理)
n创建新的 stash- 查看 stash 列表,
Enter对选中 stash 执行操作 - 支持 Pop(恢复并删除)、Apply(恢复但保留)、Drop(删除)
x清除所有 stash
Repo(仓库管理)
g/h切换 GitHub / Gitee 平台- 设置 / 删除平台 Token(自动打开浏览器创建 Token)
- Init & Push (i) — 初始化本地 Git 仓库、创建 README/.gitignore、创建远程仓库并推送
- Existing Remote (e) — 连接已有远程仓库,支持拉取同步
- 查看并切换分支(
↑↓导航,Enter切换)
快捷键
| 按键 | 功能 |
|------|------|
| F1-F4 | 切换 Tab |
| q | 退出 |
| ↑↓ | 列表导航 |
| Enter | 确认 / 选择 |
| Esc | 取消 / 关闭弹窗 |
配置
Token 和平台偏好存储在 Git 全局配置中:
wekisas.github-token— GitHub Tokenwekisas.gitee-token— Gitee Tokenwekisas.git-platform— 默认平台(github或gitee)
技术栈
- Ink — React for CLI
- TypeScript
- tsup — 构建工具
License
MIT
