{"_id":"@allenmuu/agy-hud","name":"@allenmuu/agy-hud","dist-tags":{"latest":"1.1.0"},"versions":{"1.1.0":{"name":"@allenmuu/agy-hud","version":"1.1.0","description":"Real-time, high-performance status-line HUD plugin for Google Antigravity CLI","main":"dist/agy-hud.js","bin":{"agy-hud":"dist/agy-hud.js"},"type":"module","publishConfig":{"access":"public"},"scripts":{"build":"node esbuild.config.mjs","test":"vitest run","test:watch":"vitest","typecheck":"tsc --noEmit","package":"npm run build && node scripts/package.mjs","prepack":"npm run build","prepublishOnly":"npm run build && npm test && npm run typecheck"},"keywords":["antigravity","antigravity-cli","statusline","hud","plugin","tui","npx"],"author":{"name":"Allen Muu"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/AllenMuu/agy-hud.git"},"homepage":"https://github.com/AllenMuu/agy-hud#readme","bugs":{"url":"https://github.com/AllenMuu/agy-hud/issues"},"devDependencies":{"@types/node":"^20.11.0","esbuild":"^0.20.0","typescript":"^5.3.3","vitest":"^1.2.2"},"engines":{"node":">=18.0.0"},"gitHead":"dfce1546517e5aec65ca562006276bbc398f494e","_id":"@allenmuu/agy-hud@1.1.0","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-6wbbXwx1XCz/I1xVQ1M1jTAse28NQdBKfUFD8Bk6iaWw6p6DVtw3Y2i/vfppJq1TgqA/h6p10ryUQRqt4KaV2A==","shasum":"9c0283cf5273abd502150b18d24615bcaffba776","tarball":"https://registry.npmjs.org/@allenmuu/agy-hud/-/agy-hud-1.1.0.tgz","fileCount":8,"unpackedSize":100555,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDX6O/db8OxLBHKxUe2ZN1bVZqZh15uKjZMDXwcTnhE5wIhAImvIhIC4f7Cy52xvZJkAi8kBMcxRnSBm+rWwFLcpL+8"}]},"_npmUser":{"name":"allenmuu","email":"allenqiao666@gmail.com"},"directories":{},"maintainers":[{"name":"allenmuu","email":"allenqiao666@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agy-hud_1.1.0_1787741578033_0.6519974535551094"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-26T10:52:57.828Z","1.1.0":"2026-08-26T10:52:58.174Z","modified":"2026-08-26T10:52:58.363Z"},"maintainers":[{"name":"allenmuu","email":"allenqiao666@gmail.com"}],"description":"Real-time, high-performance status-line HUD plugin for Google Antigravity CLI","homepage":"https://github.com/AllenMuu/agy-hud#readme","keywords":["antigravity","antigravity-cli","statusline","hud","plugin","tui","npx"],"repository":{"type":"git","url":"git+https://github.com/AllenMuu/agy-hud.git"},"author":{"name":"Allen Muu"},"bugs":{"url":"https://github.com/AllenMuu/agy-hud/issues"},"license":"MIT","readme":"# agy-hud: Google Antigravity CLI 实时终端 HUD 状态行插件\n\n[![npm version](https://img.shields.io/npm/v/@allenmuu/agy-hud.svg?style=flat-square)](https://www.npmjs.com/package/@allenmuu/agy-hud)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)\n[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)\n\n[English](README.md) | [简体中文](README.zh-CN.md)\n\n`agy-hud` 是专为 Google Antigravity (`agy`) CLI 打造的高性能、实时 Heads-Up Display (HUD) 状态行插件。\n\n直接在终端输入框下方呈现直观的任务进度、上下文消耗、近期工具操作、子代理状态及 Git 指标：\n\n```text\n[Gemini 3.7 Flash] │ agy-hud git:(main*) [↑1] │ 上下文 █████░░░░░ 45% (45k/1.0M)\n◐ Edit: layout.ts │ ✓ Read: package.json ×3 │ ✓ Grep: \"statusLine\" ×2 │ ◐ 子代理 [Researcher]\n▸ 任务 [2/5] (40%) │ 5h █████░ 77%余 (2h 15m) │ 周 ██████ 96%余 │ 耗时 1m 30s\n```\n\n---\n\n## 🌟 核心特性\n\n- **📊 动态上下文与模型限额**：实时跟踪 Token 容量，并根据当前模型组（Gemini 模型 / Claude & GPT 模型）自动切换展示 5 小时限额与周限额及重置倒计时。\n- **⚡ 高性能日志解析引擎**：采用尾部块倒序扫描（仅读取最后 64KB~128KB，毫秒级响应），附带 15ms 安全熔断保护。\n- **🛠️ 实时工具活动追踪**：直观展示 Agent 正在进行的编辑、读取、搜索或终端执行。\n- **🤖 子代理与后台任务监控**：实时感知运行中的 subagent 角色、耗时与 Todo 任务完成度。\n- **🌿 Git / Jujutsu 仓库感知**：零进程快速解析 Git 分支、Dirty 状态 (`*`) 与 Ahead/Behind 计数。\n- **🎛️ 交互式配置向导**：提供引导式 `setup` 与交互式 `configure` TUI，实时预览效果。\n- **🌐 原生中英文多语言**：内置简体中文 (`zh-Hans`)、繁体中文 (`zh-Hant`) 与英文 (`en`)。\n- **📦 零运行时依赖**：通过 `esbuild` 预打包为单文件 `dist/agy-hud.js`，无需安装任何额外 npm 包。\n\n---\n\n## 🚀 快速上手\n\n### 1. 一键安装 (推荐)\n\n无需手动下载压缩包或配置，在终端直接执行：\n\n```bash\nnpx @allenmuu/agy-hud install\n```\n> 或执行 `npx @allenmuu/agy-hud`。安装程序会自动部署插件文件、初始化配置文件并为 Antigravity CLI 注册 HUD 状态行。\n\n如果你更喜欢全局安装：\n```bash\nnpm install -g @allenmuu/agy-hud\nagy-hud setup\n```\n\n### 2. 生效与使用\n\n- 如果你的 Antigravity CLI 尚未启动，直接运行 `agy` 即可看到全新的 HUD 状态行。\n- 若 Antigravity 已在运行中，可在会话内运行以下命令立即刷新：\n```text\n/statusline ~/.gemini/config/plugins/agy-hud/hooks/status-line.sh\n```\n\n### 3. 自定义配置\n\n随时调整预设模式、语言与展示组件：\n\n```bash\nnpx @allenmuu/agy-hud configure\n# 或在 Antigravity 会话内直接运行：\nagy agy-hud:configure\n```\n\n---\n\n### 4. 一键卸载\n \n如果需要卸载 `agy-hud` 状态行插件：\n\n```bash\n# 干净卸载（自动注销 statusLine 并移除插件，保留自定义配置）\nnpx @allenmuu/agy-hud uninstall\n\n# 彻底清理（同时移除配置与 Quota 缓存目录）\nnpx @allenmuu/agy-hud uninstall --purge\n\n# 或在 Antigravity 会话内直接运行：\nagy agy-hud:uninstall\n```\n\n---\n\n### 📦 备选：手动归档包安装\n\n若不使用 npm / npx，也可以通过 Release 压缩包手动安装：\n\n```sh\ncurl -fsSL -o agy-hud.tar.gz https://github.com/AllenMuu/agy-hud/releases/latest/download/agy-hud.tar.gz\nmkdir -p agy-hud && tar -xzf agy-hud.tar.gz -C agy-hud\nagy plugin install ./agy-hud\n```\n\n---\n\n## 🎛️ 预设模式\n\n| 预设模式 | 行数 | 展示组件 |\n|---|---|---|\n| **Full (全功能)** | 3-4 行 | 模型徽标、项目路径、Git 状态、上下文条、近期工具操作、子代理状态、任务进度、用量与耗时 |\n| **Essential (核心)** | 2 行 | 模型徽标、项目路径、Git 状态、上下文条、近期工具操作与子代理 |\n| **Minimal (极简)** | 1 行 | 仅展示模型徽标与上下文进度条 |\n\n---\n\n## 🩺 健康诊断与环境自检\n\n自检当前 Node.js 环境、插件文件部署、Antigravity 状态行注册及日志读取延迟：\n\n```bash\nnpx @allenmuu/agy-hud doctor\n# 或在 Antigravity 会话内直接运行：\nagy agy-hud:doctor\n```\n\n---\n\n## ⌨️ CLI 常用指令速查\n\n| 指令 | 说明 |\n|---|---|\n| `npx @allenmuu/agy-hud` | 打开交互式终端管理面板（包含安装、配置、诊断、预览及卸载） |\n| `npx @allenmuu/agy-hud install` | 极速一键安装插件并自动注册 `statusLine` 到 Antigravity `settings.json` |\n| `npx @allenmuu/agy-hud configure` | 交互式配置向导（切换 Full/Essential/Minimal 预设、语言及组件开关） |\n| `npx @allenmuu/agy-hud doctor` | 运行系统环境、插件部署与状态行健康自检 |\n| `npx @allenmuu/agy-hud preview` | 在终端实时预览当前配置的 HUD 样式 |\n| `npx @allenmuu/agy-hud update-quota` | 同步模型限额缓存（支持管道输入或直接粘贴 `/usage` 输出文本） |\n| `npx @allenmuu/agy-hud quota` | 查看当前缓存的模型限额与重置倒计时 |\n| `npx @allenmuu/agy-hud uninstall` | 干净卸载插件并从 `settings.json` 注销状态行（`--purge` 连同配置一并清除） |\n\n---\n\n## 📊 同步模型用量与限额 (Quota)\n\n在 Antigravity CLI 中执行 `/usage` 命令后，将输出文本同步给 `agy-hud` 即可实时显示 5 小时与周限额进度条：\n\n```bash\nnpx @allenmuu/agy-hud update-quota \"<粘贴 /usage 输出文本>\"\n```\n\n---\n\n## 📄 开源协议\n\nMIT License © 2026 Allen Muu\n","readmeFilename":"README.zh-CN.md","_rev":"1-a4152b217135837dc927d034e25b5b7e"}