@kairyou/agent-tools 0.16.0 → 0.17.1

package/README.md

@@ -1,6 +1,6 @@
 # Agent Tools
 
-Reusable Agent Skills, plus integrations (statusline, provider usage, vision) that install into Codex, Claude Code, and opencode.
+Reusable Agent Skills, plus runtime capabilities (statusline, provider usage, vision) for Codex, Claude Code, and opencode.
 
 Requires Node.js >= 22.
 
@@ -71,7 +71,7 @@ Usage:
 
 Config: `~/.agent-tools/config.jsonc` → `"zentao": { "url", "account", "password" }`. The password can be entered directly or referenced with `"password": { "env": "ZENTAO_PASSWORD" }`; never paste credentials or tokens into chat.
 
-## Integrations
+## Capabilities
 
 Runtime capabilities, installed per agent:
 
@@ -80,7 +80,7 @@ npx -y @kairyou/agent-tools@latest <capability> -a <agent...>
 # npx -y github:kairyou/agent-tools <capability> -a <agent...>  # Or the latest code from GitHub (needs Git)
 ```
 
-`--dry-run` previews, `--uninstall` unwires the integration from the agent, and
+`--dry-run` previews, `--uninstall` removes the capability from the agent, and
 re-running the install command updates. The installer only touches config
 entries it wrote itself, and `config.jsonc` updates only add missing default
 keys without touching your edits or comments.

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md)
 
-可复用的 Agent Skills, 以及可装入 Codex, Claude Code 与 opencode 的 integrations: statusline, provider usage 与跨模型识图.
+可复用的 Agent Skills, 以及适用于 Codex, Claude Code 与 opencode 的 runtime capabilities: statusline, provider usage 与跨模型识图.
 
 需要 Node.js >= 22.
 
@@ -71,7 +71,7 @@ npx -y skills@latest add kairyou/agent-tools --skill at-zentao -g -y
 
 配置: `~/.agent-tools/config.jsonc` → `"zentao": { "url", "account", "password" }`. 密码可以直接填写, 也可以使用 `"password": { "env": "ZENTAO_PASSWORD" }` 引用环境变量; 不要在对话中粘贴凭据或 token.
 
-## Integrations
+## Capabilities
 
 Runtime capability, 按 agent 选装:
 
@@ -80,7 +80,7 @@ npx -y @kairyou/agent-tools@latest <capability> -a <agent...>
 # npx -y github:kairyou/agent-tools <capability> -a <agent...>  # 或用 GitHub 上的最新代码(需 Git)
 ```
 
-`--dry-run` 预览, `--uninstall` 解除对应集成, 重新执行安装命令即为更新.
+`--dry-run` 预览, `--uninstall` 移除对应 capability, 重新执行安装命令即为更新.
 安装器只改动自己写入的配置项, 更新 `config.jsonc` 时只补充缺失的默认键,
 不会动你的修改和注释.
 

package/{integrations → capabilities}/vision/mcp-server.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // Vision MCP stdio server. Thin shell over ./lib: registers the
 // inspect_image tool, translates results/errors, and nothing else. Launched by
-// hosts as `agent-tools mcp-vision` (or `node integrations/vision/mcp-server.mjs`).
+// hosts as `agent-tools mcp-vision` (or `node capabilities/vision/mcp-server.mjs`).
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/log/hook.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// integrations/log/hook.mjs
+// capabilities/log/hook.mjs
 import { spawnSync } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
@@ -865,7 +865,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/log/hook.mjs
+// capabilities/log/hook.mjs
 var MAX_SNAPSHOT_BYTES = 512 * 1024;
 var MIN_RESULT_SUMMARY_LENGTH = 24;
 var DAILY_ITEM_TARGET_CHARS = 160;

package/dist/log/opencode-plugin.mjs

@@ -1,4 +1,4 @@
-// integrations/log/opencode-plugin.mjs
+// capabilities/log/opencode-plugin.mjs
 import { spawn } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/statusline/claude-statusline.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// integrations/statusline/claude-statusline.mjs
+// capabilities/statusline/claude-statusline.mjs
 import { execFileSync, spawn } from "node:child_process";
 import fs from "node:fs";
 import { basename, dirname, join } from "node:path";
@@ -865,7 +865,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/statusline/claude-statusline.mjs
+// capabilities/statusline/claude-statusline.mjs
 var SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
 var AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(SCRIPT_DIR, "..", "..");
 var DEFAULT_CONFIG_FILE = join(AGENT_TOOLS_HOME, "config.jsonc");

package/dist/usage/cli.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-// integrations/usage/cli.mjs
+// capabilities/usage/cli.mjs
 import { queryAgentProviderUsage } from "./core.mjs";
 
-// integrations/usage/lib/config.mjs
+// capabilities/usage/lib/config.mjs
 import { readFile, writeFile, mkdir, open, stat } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -868,7 +868,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/usage/lib/config.mjs
+// capabilities/usage/lib/config.mjs
 var CODEX_HOME = process.env.CODEX_HOME || join(homedir(), ".codex");
 var AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(homedir(), ".agent-tools");
 var AUTH_PATH = join(CODEX_HOME, "auth.json");
@@ -931,7 +931,7 @@ async function debugLog(event) {
 }
 var HOOK_SNAPSHOT_MAX_AGE_MS = 10 * 6e4;
 
-// integrations/usage/cli.mjs
+// capabilities/usage/cli.mjs
 function parseAgent(argv) {
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];

package/dist/usage/codex-hook.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// integrations/usage/codex-hook.mjs
+// capabilities/usage/codex-hook.mjs
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

package/dist/usage/core.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
-// integrations/usage/core.mjs
+// capabilities/usage/core.mjs
 import { fileURLToPath, pathToFileURL as pathToFileURL2 } from "node:url";
 import { spawn } from "node:child_process";
 
-// integrations/usage/lib/config.mjs
+// capabilities/usage/lib/config.mjs
 import { readFile, writeFile, mkdir, open, stat } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -869,7 +869,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/usage/lib/config.mjs
+// capabilities/usage/lib/config.mjs
 var CODEX_HOME = process.env.CODEX_HOME || join(homedir(), ".codex");
 var AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(homedir(), ".agent-tools");
 var AUTH_PATH = join(CODEX_HOME, "auth.json");
@@ -954,7 +954,7 @@ async function newApiQuotaScale() {
   return Number.isFinite(scale) && scale > 0 ? scale : 0;
 }
 
-// integrations/usage/lib/urls.mjs
+// capabilities/usage/lib/urls.mjs
 function isOfficialBaseUrl(baseUrl) {
   if (!baseUrl) return true;
   const clean = baseUrl.replace(/\/+$/, "");
@@ -994,7 +994,7 @@ function hostIncludes(baseUrl, value) {
   }
 }
 
-// integrations/usage/lib/cache.mjs
+// capabilities/usage/lib/cache.mjs
 import { writeFile as writeFile2, mkdir as mkdir2, open as open2, unlink, rename, stat as stat2, utimes } from "node:fs/promises";
 import { createHash, randomUUID } from "node:crypto";
 import { dirname as dirname2, join as join2 } from "node:path";
@@ -1142,12 +1142,12 @@ async function acquireWriteLock({ timeoutMs = 500, staleMs = 5e3 } = {}) {
   return null;
 }
 
-// integrations/usage/lib/routes.mjs
+// capabilities/usage/lib/routes.mjs
 import { readdir } from "node:fs/promises";
 import { basename, extname, isAbsolute, join as join3 } from "node:path";
 import { pathToFileURL } from "node:url";
 
-// integrations/usage/lib/http.mjs
+// capabilities/usage/lib/http.mjs
 import { createContext, runInContext } from "node:vm";
 var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
 var SHIELD_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36";
@@ -1307,7 +1307,7 @@ async function requestJson(url, options = {}) {
   throw new Error(`${name} unavailable`);
 }
 
-// integrations/usage/lib/format.mjs
+// capabilities/usage/lib/format.mjs
 var ONE_API_HARD_LIMIT_SENTINEL_USD = 1e6;
 var RESET_TIME_FIELDS = Object.freeze({
   // Sub2API rate-limit entries returned alongside quota usage.
@@ -1591,7 +1591,7 @@ function formatUsageLine(root) {
   return parts.join(" | ");
 }
 
-// integrations/usage/lib/routes.mjs
+// capabilities/usage/lib/routes.mjs
 async function subscriptionUrl(baseUrl) {
   const clean = baseUrl.replace(/\/+$/, "");
   const url = clean.endsWith("/v1") ? `${clean}/usage` : `${clean}/v1/usage`;
@@ -1834,7 +1834,7 @@ async function orderedUsageRoutes(context) {
   return [cached.route, ...routeIds.filter((id) => id !== cached.route)].map((id) => registry[id]).filter(Boolean);
 }
 
-// integrations/usage/lib/context.mjs
+// capabilities/usage/lib/context.mjs
 import { existsSync as existsSync2 } from "node:fs";
 function stripInlineComment(value) {
   let inSingle = false;
@@ -1938,7 +1938,7 @@ function normalizeUsageContext(input) {
   };
 }
 
-// integrations/usage/core.mjs
+// capabilities/usage/core.mjs
 function parseArgs(argv) {
   const opts = { mode: "hook", agent: "codex", silent: false };
   let modeSet = false;

package/dist/usage/opencode-plugin.mjs

@@ -1,4 +1,4 @@
-// integrations/usage/opencode-plugin.mjs
+// capabilities/usage/opencode-plugin.mjs
 import { queryProviderUsage } from "./core.mjs";
 var DEFAULT_REFRESH_MS = 6e4;
 function firstString(value, keys) {

package/dist/usage/opencode-tui.mjs

@@ -1,4 +1,4 @@
-// integrations/usage/opencode-tui.mjs
+// capabilities/usage/opencode-tui.mjs
 import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";

package/dist/vision/cli.mjs

@@ -1,13 +1,13 @@
-// integrations/vision/lib/cli.mjs
+// capabilities/vision/lib/cli.mjs
 import fs4 from "node:fs";
 import path5 from "node:path";
 import { fileURLToPath } from "node:url";
 
-// integrations/vision/lib/inspect.mjs
+// capabilities/vision/lib/inspect.mjs
 import crypto3 from "node:crypto";
 import path4 from "node:path";
 
-// integrations/vision/lib/config.mjs
+// capabilities/vision/lib/config.mjs
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -871,7 +871,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/vision/lib/errors.mjs
+// capabilities/vision/lib/errors.mjs
 var ERROR_CODES = Object.freeze({
   CONFIG: "config_error",
   INPUT: "input_error",
@@ -899,7 +899,7 @@ function toVisionError(err, fallbackCode = ERROR_CODES.PROVIDER_HTTP) {
   return new VisionError(fallbackCode, message, { cause: err });
 }
 
-// integrations/vision/lib/config.mjs
+// capabilities/vision/lib/config.mjs
 var PROVIDERS = Object.freeze(["openai-compatible", "anthropic-compatible"]);
 var CONFIG_DEFAULTS = Object.freeze({
   timeoutMs: 3e4,
@@ -1037,7 +1037,7 @@ function loadVisionConfig({ file, env = process.env } = {}) {
   };
 }
 
-// integrations/vision/lib/image-source.mjs
+// capabilities/vision/lib/image-source.mjs
 import fs2 from "node:fs";
 import os2 from "node:os";
 import path2 from "node:path";
@@ -1285,7 +1285,7 @@ async function loadImageSource(source, { maxImageBytes, timeoutMs, fetchImpl } =
   throw new VisionError(ERROR_CODES.INPUT, `Unsupported image_source.type: ${JSON.stringify(source.type)}`);
 }
 
-// integrations/vision/lib/rate-limit.mjs
+// capabilities/vision/lib/rate-limit.mjs
 import crypto from "node:crypto";
 import fs3 from "node:fs";
 import path3 from "node:path";
@@ -1442,7 +1442,7 @@ function createLimiter(config, now = Date.now, { stateFile = null } = {}) {
   return stateFile ? createSharedLimiter(config, now, stateFile) : createProcessLimiter(config, now);
 }
 
-// integrations/vision/lib/redact.mjs
+// capabilities/vision/lib/redact.mjs
 var MASK = "***";
 function redactSecrets(text, secrets) {
   if (typeof text !== "string" || text.length === 0) return text;
@@ -1454,7 +1454,7 @@ function redactSecrets(text, secrets) {
   return out;
 }
 
-// integrations/vision/lib/providers/shared.mjs
+// capabilities/vision/lib/providers/shared.mjs
 import crypto2 from "node:crypto";
 async function* encodeBase64(readable) {
   let carry = Buffer.alloc(0);
@@ -1667,7 +1667,7 @@ async function postJson({ url, headers, body, timeoutMs, fetchImpl, providerLabe
   }
 }
 
-// integrations/vision/lib/providers/anthropic-compatible.mjs
+// capabilities/vision/lib/providers/anthropic-compatible.mjs
 function messagesUrl(baseUrl) {
   return baseUrl.endsWith("/v1") ? `${baseUrl}/messages` : `${baseUrl}/v1/messages`;
 }
@@ -1718,7 +1718,7 @@ async function inspectWithAnthropicCompatible({ config, image, questions, fetchI
   return normalizeAnswers(text, questions);
 }
 
-// integrations/vision/lib/providers/openai-compatible.mjs
+// capabilities/vision/lib/providers/openai-compatible.mjs
 function replyText2(json) {
   const message = json?.choices?.[0]?.message;
   if (typeof message?.content === "string") return message.content;
@@ -1765,7 +1765,7 @@ async function inspectWithOpenAICompatible({ config, image, questions, fetchImpl
   return normalizeAnswers(text, questions);
 }
 
-// integrations/vision/lib/inspect.mjs
+// capabilities/vision/lib/inspect.mjs
 var PROVIDER_IMPL = {
   "openai-compatible": inspectWithOpenAICompatible,
   "anthropic-compatible": inspectWithAnthropicCompatible
@@ -1849,7 +1849,7 @@ function createVisionService({ config, fetchImpl, now, limiterStateFile } = {})
   return { config: resolved, inspect };
 }
 
-// integrations/vision/lib/cli.mjs
+// capabilities/vision/lib/cli.mjs
 function printHelp() {
   const lines = [];
   for (const line of fs4.readFileSync(fileURLToPath(import.meta.url), "utf8").split("\n")) {

package/dist/vision/mcp-server.mjs

@@ -30952,11 +30952,11 @@ var StdioServerTransport = class {
   }
 };
 
-// integrations/vision/lib/inspect.mjs
+// capabilities/vision/lib/inspect.mjs
 import crypto3 from "node:crypto";
 import path4 from "node:path";
 
-// integrations/vision/lib/config.mjs
+// capabilities/vision/lib/config.mjs
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -31820,7 +31820,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/vision/lib/errors.mjs
+// capabilities/vision/lib/errors.mjs
 var ERROR_CODES = Object.freeze({
   CONFIG: "config_error",
   INPUT: "input_error",
@@ -31848,7 +31848,7 @@ function toVisionError(err, fallbackCode = ERROR_CODES.PROVIDER_HTTP) {
   return new VisionError(fallbackCode, message, { cause: err });
 }
 
-// integrations/vision/lib/config.mjs
+// capabilities/vision/lib/config.mjs
 var PROVIDERS = Object.freeze(["openai-compatible", "anthropic-compatible"]);
 var CONFIG_DEFAULTS = Object.freeze({
   timeoutMs: 3e4,
@@ -31986,7 +31986,7 @@ function loadVisionConfig({ file: file2, env = process.env } = {}) {
   };
 }
 
-// integrations/vision/lib/image-source.mjs
+// capabilities/vision/lib/image-source.mjs
 import fs2 from "node:fs";
 import os2 from "node:os";
 import path2 from "node:path";
@@ -32234,7 +32234,7 @@ async function loadImageSource(source, { maxImageBytes, timeoutMs, fetchImpl } =
   throw new VisionError(ERROR_CODES.INPUT, `Unsupported image_source.type: ${JSON.stringify(source.type)}`);
 }
 
-// integrations/vision/lib/rate-limit.mjs
+// capabilities/vision/lib/rate-limit.mjs
 import crypto from "node:crypto";
 import fs3 from "node:fs";
 import path3 from "node:path";
@@ -32391,7 +32391,7 @@ function createLimiter(config2, now = Date.now, { stateFile = null } = {}) {
   return stateFile ? createSharedLimiter(config2, now, stateFile) : createProcessLimiter(config2, now);
 }
 
-// integrations/vision/lib/redact.mjs
+// capabilities/vision/lib/redact.mjs
 var MASK = "***";
 function redactSecrets(text, secrets) {
   if (typeof text !== "string" || text.length === 0) return text;
@@ -32403,7 +32403,7 @@ function redactSecrets(text, secrets) {
   return out;
 }
 
-// integrations/vision/lib/providers/shared.mjs
+// capabilities/vision/lib/providers/shared.mjs
 import crypto2 from "node:crypto";
 async function* encodeBase64(readable) {
   let carry = Buffer.alloc(0);
@@ -32616,7 +32616,7 @@ async function postJson({ url: url2, headers, body, timeoutMs, fetchImpl, provid
   }
 }
 
-// integrations/vision/lib/providers/anthropic-compatible.mjs
+// capabilities/vision/lib/providers/anthropic-compatible.mjs
 function messagesUrl(baseUrl) {
   return baseUrl.endsWith("/v1") ? `${baseUrl}/messages` : `${baseUrl}/v1/messages`;
 }
@@ -32667,7 +32667,7 @@ async function inspectWithAnthropicCompatible({ config: config2, image, question
   return normalizeAnswers(text, questions);
 }
 
-// integrations/vision/lib/providers/openai-compatible.mjs
+// capabilities/vision/lib/providers/openai-compatible.mjs
 function replyText2(json2) {
   const message = json2?.choices?.[0]?.message;
   if (typeof message?.content === "string") return message.content;
@@ -32714,7 +32714,7 @@ async function inspectWithOpenAICompatible({ config: config2, image, questions,
   return normalizeAnswers(text, questions);
 }
 
-// integrations/vision/lib/inspect.mjs
+// capabilities/vision/lib/inspect.mjs
 var PROVIDER_IMPL = {
   "openai-compatible": inspectWithOpenAICompatible,
   "anthropic-compatible": inspectWithAnthropicCompatible
@@ -32798,7 +32798,7 @@ function createVisionService({ config: config2, fetchImpl, now, limiterStateFile
   return { config: resolved, inspect };
 }
 
-// integrations/vision/mcp-server.mjs
+// capabilities/vision/mcp-server.mjs
 var TOOL_DESCRIPTION = [
   "Use the configured vision model when the user's task depends on visible content and only a local image path or http(s) URL is available, direct inspection failed, or the user explicitly requested the provider.",
   "If the prompt already contains actual image content or a host image viewer returned it, inspect that content directly; a bare path or URL without a visual task is not a reason to call this.",

package/docs/en/repository-structure.md

@@ -4,7 +4,7 @@
 agent-tools/
 ├── .claude-plugin/    # Claude Code/plugin ecosystem manifest.
 ├── .codex-plugin/     # Codex plugin manifest.
-├── integrations/      # Installable capabilities, one directory each.
+├── capabilities/      # Runtime capabilities, one directory each.
 │   ├── statusline/    # Agent status line: branch, model, usage.
 │   ├── usage/         # Provider balance / quota display.
 │   └── vision/        # Cross-model image understanding.
@@ -13,7 +13,7 @@ agent-tools/
 │   │   ├── at-commit/   # Conventional Commit message skill.
 │   │   ├── at-review/   # Review local or hosted changes for bugs and regressions.
 │   │   └── at-simplify/ # Reduce complexity and duplication in changes.
-│   └── integrations/  # Skills that integrate external systems.
+│   └── systems/       # Self-contained Skills for external systems.
 │       └── at-zentao/   # Self-contained ZenTao workflow and secure API script.
 ├── docs/              # Advanced guides and contributor reference.
 ├── tools/             # Maintainer-only upstream sync and repository tooling.

package/docs/zh-CN/repository-structure.md

@@ -4,7 +4,7 @@
 agent-tools/
 ├── .claude-plugin/    # Claude Code/plugin 生态的 manifest.
 ├── .codex-plugin/     # Codex plugin manifest.
-├── integrations/      # 可安装的 capability, 一个一目录.
+├── capabilities/      # Runtime capabilities, 一个一目录.
 │   ├── statusline/    # Agent 状态栏: 分支, 模型, 用量.
 │   ├── usage/         # Provider 余额/额度显示.
 │   └── vision/        # 跨模型识图.
@@ -13,7 +13,7 @@ agent-tools/
 │   │   ├── at-commit/   # 生成 Conventional Commits message.
 │   │   ├── at-review/   # 审查本地或托管改动中的 bug 与回归风险.
 │   │   └── at-simplify/ # 减少改动中的冗余和复杂度.
-│   └── integrations/  # 对接外部系统的 skills.
+│   └── systems/       # 面向外部系统的自包含 Skills.
 │       └── at-zentao/   # 自包含的禅道工作流和安全 API 脚本.
 ├── docs/              # 高级指南和贡献者参考.
 ├── tools/             # 仅供维护者使用的上游同步和仓库工具.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kairyou/agent-tools",
-  "version": "0.16.0",
-  "description": "Reusable Agent Skills, plus integrations (statusline, provider usage, vision) that install into Codex, Claude Code, and opencode.",
+  "version": "0.17.1",
+  "description": "Reusable Agent Skills, plus runtime capabilities (statusline, provider usage, vision) for Codex, Claude Code, and opencode.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     "config.default.jsonc",
     "docs/",
     "dist/",
-    "integrations/",
+    "capabilities/",
     "scripts/",
     "skills/"
   ],

package/scripts/build.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // Bundles everything that ships to ~/.agent-tools into dist/<capability>.
-// Installed artifacts are always built output; integrations/ holds the sources.
+// Installed artifacts are always built output; capabilities/ holds the sources.
 
 import fs from "node:fs";
 import path from "node:path";
@@ -13,16 +13,16 @@ const DIST = path.join(ROOT, "dist");
 const TARGETS = {
   statusline: {
     entryPoints: {
-      "claude-statusline": path.join(ROOT, "integrations", "statusline", "claude-statusline.mjs"),
+      "claude-statusline": path.join(ROOT, "capabilities", "statusline", "claude-statusline.mjs"),
     },
   },
   usage: {
     entryPoints: {
-      core: path.join(ROOT, "integrations", "usage", "core.mjs"),
-      cli: path.join(ROOT, "integrations", "usage", "cli.mjs"),
-      "codex-hook": path.join(ROOT, "integrations", "usage", "codex-hook.mjs"),
-      "opencode-plugin": path.join(ROOT, "integrations", "usage", "opencode-plugin.mjs"),
-      "opencode-tui": path.join(ROOT, "integrations", "usage", "opencode-tui.mjs"),
+      core: path.join(ROOT, "capabilities", "usage", "core.mjs"),
+      cli: path.join(ROOT, "capabilities", "usage", "cli.mjs"),
+      "codex-hook": path.join(ROOT, "capabilities", "usage", "codex-hook.mjs"),
+      "opencode-plugin": path.join(ROOT, "capabilities", "usage", "opencode-plugin.mjs"),
+      "opencode-tui": path.join(ROOT, "capabilities", "usage", "opencode-tui.mjs"),
     },
     // core.mjs detects "run as a script" via process.argv[1]; inlining it into
     // the other entries would re-trigger that check inside their bundles, so it
@@ -31,21 +31,21 @@ const TARGETS = {
   },
   vision: {
     entryPoints: {
-      "mcp-server": path.join(ROOT, "integrations", "vision", "mcp-server.mjs"),
-      cli: path.join(ROOT, "integrations", "vision", "lib", "cli.mjs"),
+      "mcp-server": path.join(ROOT, "capabilities", "vision", "mcp-server.mjs"),
+      cli: path.join(ROOT, "capabilities", "vision", "lib", "cli.mjs"),
     },
   },
   log: {
     entryPoints: {
-      hook: path.join(ROOT, "integrations", "log", "hook.mjs"),
-      "opencode-plugin": path.join(ROOT, "integrations", "log", "opencode-plugin.mjs"),
+      hook: path.join(ROOT, "capabilities", "log", "hook.mjs"),
+      "opencode-plugin": path.join(ROOT, "capabilities", "log", "opencode-plugin.mjs"),
     },
   },
 };
 
-// Repo-shipped usage routes (a fork can commit integrations/usage/routes/*.mjs
+// Repo-shipped usage routes (a fork can commit capabilities/usage/routes/*.mjs
 // to distribute custom gateways to everyone who installs). Absent upstream.
-const USAGE_ROUTES_DIR = path.join(ROOT, "integrations", "usage", "routes");
+const USAGE_ROUTES_DIR = path.join(ROOT, "capabilities", "usage", "routes");
 if (fs.existsSync(USAGE_ROUTES_DIR)) {
   for (const file of fs.readdirSync(USAGE_ROUTES_DIR).filter((n) => n.endsWith(".mjs"))) {
     TARGETS.usage.entryPoints[`routes/${file.slice(0, -4)}`] = path.join(USAGE_ROUTES_DIR, file);

package/scripts/install.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // agent-tools installer: wires statusline / usage into each agent's config.
 // Runtime-dependent skills are installed with their capability. Standalone
-// workflow/integration skills are still handled by `npx skills add`.
+// Standalone skills are still handled by `npx skills add`.
 //
 // Capabilities (all global for now — they target the user-level config):
 //   statusline  Claude Code statusLine script (claude only).
@@ -68,7 +68,7 @@ const PACKAGE_VERSION = (() => {
   }
 })();
 // Everything copied into ~/.agent-tools is built output from dist/ (see
-// scripts/build.mjs); integrations/ holds the sources.
+// scripts/build.mjs); capabilities/ holds the sources.
 const SOURCE = {
   logHook: path.join(REPO_ROOT, "dist", "log", "hook.mjs"),
   logOpencodePlugin: path.join(REPO_ROOT, "dist", "log", "opencode-plugin.mjs"),
@@ -100,12 +100,12 @@ const AGENT_CAPS = {
 };
 const VISION_MCP_NAME = "agent-tools-vision";
 const VISION_SKILL_NAME = "at-vision";
-// The at-vision skill ships inside the vision capability dir (integrations/vision),
+// The at-vision skill ships inside the vision capability dir (capabilities/vision),
 // not skills/: it is unusable without the MCP server, so it must not surface
 // as an independently installable skill.
-const VISION_SKILL_SRC = path.join(REPO_ROOT, "integrations", "vision", "skills", VISION_SKILL_NAME);
+const VISION_SKILL_SRC = path.join(REPO_ROOT, "capabilities", "vision", "skills", VISION_SKILL_NAME);
 const USAGE_SKILL_NAME = "at-usage";
-const USAGE_SKILL_SRC = path.join(REPO_ROOT, "integrations", "usage", "skills", USAGE_SKILL_NAME);
+const USAGE_SKILL_SRC = path.join(REPO_ROOT, "capabilities", "usage", "skills", USAGE_SKILL_NAME);
 const VISION_BUNDLED_MCP_SERVER = path.join(REPO_ROOT, "dist", "vision", "mcp-server.mjs");
 const VISION_BUNDLED_CLI = path.join(REPO_ROOT, "dist", "vision", "cli.mjs");
 const INSTALL_STATE_PATH = path.join(INSTALL_ROOT, "install-state.json");
@@ -292,7 +292,7 @@ function syncUsageRoutesDir(dryRun) {
 function parseArgs(argv) {
   const opts = {
     agents: [],
-    integrations: [],
+    capabilities: [],
     settings: null,
     codexHooks: null,
     opencodeConfigDir: null,
@@ -343,15 +343,15 @@ function parseArgs(argv) {
           console.error(`Unknown option: ${a}`);
           process.exit(2);
         }
-        opts.integrations.push(a);
+        opts.capabilities.push(a);
     }
   }
   if (opts.agents.length === 0) opts.agents = ["claude"];
-  if (!opts.help && opts.integrations.length === 0) {
+  if (!opts.help && opts.capabilities.length === 0) {
     console.error(`Missing capability (available: ${ALL_CAPS.join(", ")})`);
     process.exit(2);
   }
-  for (const name of opts.integrations) {
+  for (const name of opts.capabilities) {
     if (!ALL_CAPS.includes(name)) {
       console.error(`Unknown capability: ${name} (available: ${ALL_CAPS.join(", ")})`);
       process.exit(2);
@@ -361,14 +361,14 @@ function parseArgs(argv) {
 }
 
 function wants(opts, cap) {
-  return opts.integrations.length === 0 || opts.integrations.includes(cap);
+  return opts.capabilities.length === 0 || opts.capabilities.includes(cap);
 }
 
 function validateAgentCapabilities(opts) {
   const invalid = [];
   for (const agent of opts.agents) {
     const supported = AGENT_CAPS[agent] || [];
-    for (const cap of opts.integrations) {
+    for (const cap of opts.capabilities) {
       if (!supported.includes(cap)) invalid.push(`${cap} -a ${agent}`);
     }
   }
@@ -1181,7 +1181,7 @@ function cleanupVisionRuntimeIfUnused(opts) {
     try {
       fs.rmdirSync(path.dirname(VISION_RATE_LIMIT_STATE));
     } catch {
-      // The shared cache directory may contain state for other integrations.
+      // The shared cache directory may contain state for other capabilities.
     }
   }
   console.log(`  removed unused vision runtime ${VISION_RUNTIME_DIR}`);
@@ -1218,7 +1218,7 @@ function main() {
 }
 
 // Standalone vision commands dispatch before capability parsing so image
-// paths and questions are never mistaken for integrations.
+// paths and questions are never mistaken for capabilities.
 const subcommand = process.argv[2];
 if (subcommand === "inspect-image") {
   const { runInspectImageCli } = await import(