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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-posh-git/raw/index.md(查看排版版本)