@kairyou/agent-tools 0.7.1 → 0.7.2

package/README.md

@@ -95,10 +95,14 @@ output is:
 
 ```text
 ⎇ main | Opus 4.8 | 5h 7% ⟳2h54m | w 41% ⟳3d1h
+
+# With a compatible API relay, its quota info is shown instead, e.g.:
+⎇ main | Opus 4.8 | API | balance $362 | today $61.7 | 30d $566
 ```
 
-Here `5h` and `w` are Claude's rolling usage windows; `⟳` is the reset countdown.
-When a compatible API relay is active, the statusline also appends provider usage.
+Here `5h` and `w` are Claude's rolling usage windows and `⟳` is the reset
+countdown; see [Provider usage](#provider-usage) below for relay quota
+compatibility and configuration.
 
 To choose what appears, edit `statusline.fields` in
 `~/.agent-tools/config.jsonc`. Installer updates only add missing default keys
@@ -149,6 +153,19 @@ Keep `preset` set to `auto` for automatic detection. Select a specific protocol
 only when you know which usage endpoint the gateway exposes; a configured
 custom route id is also accepted.
 
+Output examples:
+
+```text
+# Relay plan quota.
+API | D $0.0/$100 | W $0.0/$300 | Exp 07-08
+
+# Wallet balance.
+API | balance $362 | today $61.7 | 30d $566
+```
+
+Fields: `D/W/M` are daily/weekly/monthly spend against plan limits; `Exp` is
+the plan expiry; `balance` is wallet credit; `today` and `30d` are API spend.
+
 #### Custom gateway routes
 
 For gateways the built-in probes cannot reach (e.g. cookie-authenticated
@@ -198,19 +215,6 @@ export async function run(context, { requestJson, agentConfig }) {
 through to the next route (with `providerUsage.debug` enabled, failures are
 logged to `~/.agent-tools/logs/usage-debug.log`).
 
-Output examples:
-
-```text
-# Relay plan quota.
-API | D $0.0/$100 | W $0.0/$300 | Exp 07-08
-
-# Wallet balance.
-API | balance $362 | today $61.7 | 30d $566
-```
-
-Fields: `D/W/M` are daily/weekly/monthly spend against plan limits; `Exp` is
-the plan expiry; `balance` is wallet credit; `today` and `30d` are API spend.
-
 ### Vision (cross-model image understanding)
 
 Lets a main model that cannot see images ask a multimodal model specific questions about an image (local path or http(s) URL) and reason on from the answers. Typical uses: reading error screenshots, implementing UI from design mockups, locating the glitch in a bug-report screenshot. One installer capability bundling three parts: the `inspect_image` MCP stdio server, the `at-vision` policy skill, and a human diagnostic CLI.

package/README.zh-CN.md

@@ -90,10 +90,13 @@ npx -y @kairyou/agent-tools@latest statusline -a claude
 
 ```text
 ⎇ main | Opus 4.8 | 5h 7% ⟳2h54m | w 41% ⟳3d1h
+
+# 使用兼容的 API 中转时, 显示中转的额度信息, 比如:
+⎇ main | Opus 4.8 | API | balance $362 | today $61.7 | 30d $566
 ```
 
-其中 `5h` / `w` 是 Claude 的滚动用量窗口, `⟳` 后面是重置倒计时.
-使用兼容的 API 中转时, statusline 还会追加 provider usage.
+其中 `5h` / `w` 是 Claude 的滚动用量窗口, `⟳` 后面是重置倒计时;
+中转额度信息的兼容性与配置见下方 [Provider usage](#provider-usage).
 
 如需控制显示项, 修改 `~/.agent-tools/config.jsonc` 里的
 `statusline.fields`. 安装器更新时只会补充缺失的默认键, 不会动你的修改和注释.
@@ -138,6 +141,19 @@ provider 的 `base_url` 和密钥; Claude Code: 读取 `ANTHROPIC_BASE_URL` 与
 保持 `preset: "auto"` 即可自动探测. 只有明确知道网关开放的是哪种用量协议时,
 才指定相应的内置 preset 或已配置的自定义 route id.
 
+显示效果示例:
+
+```text
+# 中转套餐额度.
+API | D $0.0/$100 | W $0.0/$300 | Exp 07-08
+
+# 钱包余额.
+API | balance $362 | today $61.7 | 30d $566
+```
+
+字段含义: `D/W/M` 是日/周/月套餐消耗与上限, `Exp` 是套餐到期日,
+`balance` 是钱包余额, `today` / `30d` 是今日与近 30 天 API 消耗.
+
 #### 自定义网关路由
 
 内置探测覆盖不到的网关(比如 cookie 认证的中转), 可以自己写路由模块并在
@@ -184,19 +200,6 @@ export async function run(context, { requestJson, agentConfig }) {
 `text` 是自由字符串; 成功返回 `{ text }`, 抛错则回落到下一条路由
 (开启 `providerUsage.debug` 后, 失败会记录到 `~/.agent-tools/logs/usage-debug.log`).
 
-显示效果示例:
-
-```text
-# 中转套餐额度.
-API | D $0.0/$100 | W $0.0/$300 | Exp 07-08
-
-# 钱包余额.
-API | balance $362 | today $61.7 | 30d $566
-```
-
-字段含义: `D/W/M` 是日/周/月套餐消耗与上限, `Exp` 是套餐到期日,
-`balance` 是钱包余额, `today` / `30d` 是今日与近 30 天 API 消耗.
-
 ### Vision(跨模型识图)
 
 让不支持图片的主模型借助多模态模型识图: 针对图片(本地路径或 http(s) URL)提出具体问题, 拿到答案后继续自己的推理. 常见场景: 读取报错截图, 按设计稿还原 UI, 定位测试反馈截图里的界面问题. 一个安装器 capability 包含三部分: `inspect_image` MCP stdio server, `at-vision` 策略 skill, 以及人工诊断 CLI.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kairyou/agent-tools",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Reusable Agent Skills and installable integrations (statusline, provider usage, vision) for Codex, Claude Code, and opencode.",
   "license": "MIT",
   "engines": {

package/scripts/install.mjs

@@ -242,7 +242,9 @@ function installRuntimeAssets(opts) {
   }
   console.log(`runtime: ${INSTALL_ROOT}`);
   for (const [src, dest, options] of files) copyRuntimeFile(src, dest, opts.dryRun, options);
-  if (wants(opts, "usage")) syncUsageRoutesDir(opts.dryRun);
+  // The statusline refreshes via the usage engine, so it needs packaged
+  // routes too.
+  if (wants(opts, "usage") || wants(opts, "statusline")) syncUsageRoutesDir(opts.dryRun);
 }
 
 // Repo-shipped usage routes are replaced wholesale so routes removed from the