pi-posh-git

为pi终端提供常驻显示的git状态信息

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-posh-git。
它的用途是:为pi终端提供常驻显示的git状态信息
完整的 Skill 内容见:https://321skill.com/skills/pi-posh-git/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“进入我的项目目录”,AI会执行`cd your-project`命令。随后,你无需任何操作,就能在终端底部看到类似 `main ↑1 ↓2 +3 ~4 !5 stash:2` 的状态栏,它告诉你当前在main分支,领先远程1个提交、落后2个提交,有3个已暂存、4个已修改、5个未跟踪的文件,以及2个存储项。

介绍

pi-posh-git 解决了开发者在终端操作时,需要频繁输入git status等命令才能查看当前Git仓库状态的问题。它通过在终端底部页脚(footer)区域,持续、实时地显示Git分支、提交状态、文件变更计数等信息,让你对仓库状态一目了然。

使用方式非常简单,安装后无需额外操作。当你进入任何一个Git仓库目录时,终端界面的底部就会自动出现一个状态栏。这个状态栏会显示当前分支名、本地分支领先或落后远程分支的提交数量、暂存区和工作区的文件变更数量,以及存储区(stash)的数量。

这个Skill非常适合所有使用pi终端进行日常开发的程序员,尤其是频繁在命令行中进行Git操作、切换分支、提交代码的开发者。它能极大提升在终端环境下的Git工作流效率。

建议在屏幕空间足够的终端中使用,以获得最佳体验。由于信息常驻显示,可能会略微占用终端底部的显示行数,但在熟悉其布局后,它能成为你无需主动查询的“第二视觉”,帮助你快速做出提交、合并等决策。

核心特点

与同类仅在提示符(PS1)中显示Git状态的工具不同,pi-posh-git将状态信息固定在终端窗口的底部页脚区域,实现了真正的“常驻”和“全局”可见,无论你运行什么命令或滚动历史输出,状态信息始终在屏幕固定位置。

注意事项

不适合屏幕高度非常有限或不喜欢界面底部有固定信息栏的用户。

常见问题

pi-posh-git 和 posh-git 有什么区别?

posh-git 是为 PowerShell 设计的,而 pi-posh-git 是专门为 pi 终端环境实现的类似功能。

状态信息会干扰命令行输入吗?

不会,状态显示在独立的底部页脚区域,不会影响主输入区域的历史记录和当前输入行。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-posh-git/raw/index.md 读取 pi-posh-git 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。