为 Google Antigravity CLI 打造的可配置状态栏 agy-powerline

为 Google Antigravity 的 CLI 打造的一款快速、可配置的状态栏（agy）。

一眼即可查看你的模型、Gemini 5 小时/7 天配额、上下文窗口、git 分支等更多信息。通过交互式编辑器挑选组件、主题和布局。一条命令即可安装，无依赖。

安装

你需要 Node.js 20+ 和 Antigravity CLI。支持 Windows、macOS、Linux 和 WSL（WSL 说明）。

npx agy-powerline init        # install the statusline into agy
npx agy-powerline configure   # optional: pick widgets, theme and layout
agy                           # start Antigravity

init 在替换任何内容前会先询问，并先备份 Antigravity 的 settings.json。在 init 后重启一次 agy。详情：init 会做什么。

对于没有 Nerd Font 的终端，请开启 ASCII 模式（在 configure 中设置 i）。

自定义

npx agy-powerline configure 会打开一个编辑器，并实时预览你的状态栏。使用 ← → 在 Widgets、Presets、Themes、Layout 和 Powerline 之间切换，用 ↑ ↓ 移动，按 Enter 选择，按 q 保存并退出。每个界面的按键都显示在底部；完整列表见 Configuration。

更改会在运行中的 agy 下次刷新时生效。

预设

从预设开始，然后进行调整：

预设	显示内容
`default`	模型、上下文、git；5 小时和 7 天配额及重置时间显示在第二行
`compact`	一行：简短模型、最紧张的配额、上下文百分比、git
`workspace`	项目、git、agent 状态、模型；上下文和最紧张的配额
`limits`	所有配额（5 小时、7 天、第三方），每行一个
`full`	全部内容：会话、项目和 git；上下文、token 和缓存；两种配额

主题

终端背景	主题
深色	`dark-aurora`（默认）、`dark-ocean`、`dark-ember`、`dark-forest`、`dark-neon`、`dark-mono`、`dark-nocturne`、`dark-onyx`、`dark-metro`
浅色	`light-paper`、`light-sky`、`light-sunset`、`light-cream`
色盲友好	`colorblind-dark`、`colorblind-light`
你自己的颜色	`custom`（如何操作）

用 npx agy-powerline theme --gallery 预览全部主题。

布局

Pills（默认）：powerline 风格的胶囊。可选择圆形、斜角、倾斜或扁平形状，并可选在行之间加一个空行。

Lines：以纯彩色文本显示相同信息。

组件

组件	显示内容
`model`	正在使用的模型
`fiveHourBar`、`weeklyBar`	以进度条显示剩余的 5 小时 / 7 天配额，并带有进度标记
`fiveHourPct`、`weeklyPct`	以百分比显示剩余的 5 小时 / 7 天配额
`fiveHourReset`、`weeklyReset`	配额重置的剩余时间，或重置时间
`quota`	最接近耗尽的配额及其重置时间
`thirdPartyFiveHour`、`thirdPartyWeekly`	第三方模型配额
`context`、`contextPct`、`contextTokens`	已使用的上下文窗口：进度条、百分比或 token 数量
`git`	分支、未提交的更改以及领先/落后
`project`、`cwd`	项目文件夹、当前文件夹
`agentState`、`plan`、`sandbox`、`artifacts`、`version`	agent 正在做什么、你的计划、沙箱、artifacts、CLI 版本
`totalTokens`、`cacheHit`、`cacheRead`、`cacheCreate`	会话 token 和提示缓存使用情况
`ram`	你机器上使用的内存
`customText`、`exec`	你自己的文本，或 shell 命令的输出

没有内容可显示的组件会自动隐藏。组件可以重新着色、去掉标签或设置自己的警报阈值：见 Configuration。

命令

命令	作用
`npx agy-powerline init [--yes]`	安装或更新状态栏
`npx agy-powerline configure`	打开编辑器（别名 `config`）
`npx agy-powerline preset <name>`	应用预设（用 `--list` 查看全部）
`npx agy-powerline theme <name>`	切换主题（`--list`、`--gallery`）
`npx agy-powerline layout <pills\|lines>`	切换布局
`npx agy-powerline caps <style>`	切换胶囊形状：`round`、`angled`、`slanted`、`flat`
`npx agy-powerline doctor`	检查安装并说明问题所在
`npx agy-powerline report`	生成一份隐私安全的 bug 报告
`npx agy-powerline uninstall [--delete]`	从 agy 中移除（`--delete` 还会移除其文件）
`npx agy-powerline render --demo`	用示例数据打印状态栏

用 --help 运行任何命令以查看其选项。

更新

npx agy-powerline init --yes   # install the new version's scripts
npx agy-powerline doctor       # check everything is up to date

你的设置会被保留。之后重启 agy。

故障排除

先运行 npx agy-powerline doctor：它会检查安装并告诉你如何修复发现的问题。常见问题及如何报告 bug：Troubleshooting。

隐私与安全

无网络调用，无遥测。所有内容都来自 agy 传递给状态栏的数据、来自 .git 以及来自你的操作系统。唯一的外部链接是 configure 中的 g，它会在你的浏览器中打开 GitHub 页面。
你的设置是安全的。init 和 uninstall 会备份 settings.json，并拒绝编辑无法解析的文件。
除非你主动添加，否则什么都不会运行。除了为获取 ahead/behind 计数而快速调用一次 git 外，该栏运行的唯一命令就是你自行配置的 exec 小部件。
零运行时依赖，通过 CI 发布，并带有 npm 来源证明。

完整详情：SECURITY.md。

贡献

欢迎贡献。请从 CONTRIBUTING.md（环境搭建、架构、添加小部件或主题）和行为准则开始。请针对 develop 提交拉取请求。在 GitHub issues 中报告 bug 和提问。

为 Google Antigravity CLI 打造的可配置状态栏 agy-powerline

安装

自定义

预设

主题

布局

组件

命令

更新

故障排除

隐私与安全

贡献

许可证