Agent Tools

Reusable Agent Skills and installable integrations — statusline, provider usage, and vision — for Codex, Claude Code, and opencode.

Requires Node.js >= 22.

中文

Skills

Install

# List available skills
npx -y skills@latest add kairyou/agent-tools --list

# Install globally (pass one or more names after --skill)
npx -y skills@latest add kairyou/agent-tools --skill <name...> -g -y

at-commit

Generate a Conventional Commits message from staged changes and wait for user confirmation before committing.

npx -y skills@latest add kairyou/agent-tools --skill at-commit -g -y

Usage:

• /at-commit [<language>] — language for the commit description (Conventional Commits tokens stay in English)

at-review

Review changes for correctness bugs, regressions, convention violations, and high-value cleanup findings.

npx -y skills@latest add kairyou/agent-tools --skill at-review -g -y

Usage:

• /at-review [--fix] [<pr|branch|path>] — reports findings; --fix also applies them

at-simplify

Refactor changes to reduce duplication, lower complexity, and improve code quality.

npx -y skills@latest add kairyou/agent-tools --skill at-simplify -g -y

Usage:

• /at-simplify [<pr|branch|path>]

at-zentao

Work ZenTao (禅道) bugs/tasks end to end: fix, verify, stage; asks before committing and before writing status back.

npx -y skills@latest add kairyou/agent-tools --skill at-zentao -g -y

Usage:

• /at-zentao bugs — list bugs assigned to you (the configured account); pick one or several (several = batch mode)
• /at-zentao tasks — same, for tasks
• /at-zentao bug <id> — work a specific bug
• /at-zentao task <id> — work a specific task

Config: ~/.agent-tools/config.jsonc → "zentao": { "url", "account", "password" }. First run guides you; fill password in the file yourself (or env ZENTAO_PASSWORD), never in chat.

Integrations

Runtime capabilities, installed per agent:

npx -y @kairyou/agent-tools@latest <capability> -a <agent...>

--dry-run previews, --uninstall unwires the integration 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.

Statusline

npx -y @kairyou/agent-tools@latest statusline -a claude

The installer writes statusLine to ~/.claude/settings.json. Example output:

# Pick and order the fields via statusline.fields in ~/.agent-tools/config.jsonc:
⎇ main | Opus 4.8 | 5h 7% ⟳2h54m | w 41% ⟳3d1h

# With a compatible API relay, quota info is shown too:
⎇ main | Opus 4.8 | balance $362 | today $61.7 | 30d $566

Here 5h and w are Claude's rolling usage windows and ⟳ is the reset countdown; see Provider usage below for relay quota compatibility and configuration.

Provider usage

Shows API relay / gateway balance and quota inside the agent. Supports Sub2API, One API (including OneHub and DoneHub), New API, Claude Code Hub, and OpenRouter; compatibility depends on the gateway version and enabled usage endpoints.

npx -y @kairyou/agent-tools@latest usage -a claude codex opencode

• Claude Code — invoke /at-usage to show the current usage.
• Codex — run /hooks once after installation to approve it. The Codex CLI displays usage automatically; clients that hide hook output can use $at-usage.
• OpenCode — usage refreshes when the session goes idle and appears as a toast; /at-usage shows it on demand. Restart opencode after installing or updating.

The relay endpoint is auto-discovered from the existing Codex and Claude Code configuration; official (non-relay) endpoints are skipped. If it reports Provider usage is unavailable., set PROVIDER_USAGE_BASE_URL and PROVIDER_USAGE_API_KEY to override the endpoint and key. Configure providerUsage in ~/.agent-tools/config.jsonc only when needed:

{
  "providerUsage": {
    // auto | sub2api | openai-compatible | one-api | one-hub |
    // done-hub | new-api | claude-code-hub | openrouter | <custom-route-id>
    "preset": "auto",
    "days": 30,       // how many recent days of spend to count
    "debug": false    // true: log probes to ~/.agent-tools/logs/usage-debug.log
  }
}

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:

# Plan limits (sub2api / openai-compatible).
D $0.0/$100 | W $0.0/$300 | Exp 07-08

# Multi-window limits (claude-code-hub).
5h $2.1/$10.0 | D $8.0/$20.0 | T $19.0/$100 | Exp 08-31

# Balance and usage (one-api / one-hub / done-hub / new-api / openrouter).
balance $15.0 | used $5.0/$20.0

# Wallet and recent spend (sub2api).
balance $362 | today $61.7 | 30d $566

Fields: 5h/D/W/M/T are five-hour/daily/weekly/monthly/total spend against limits; Exp is the plan expiry; balance is wallet credit; used is consumed credit; today and 30d are today's and the last 30 days' API spend.

Custom gateway routes

Gateways not covered by the built-in probes can use a custom route. See Custom gateway routes.

Vision (cross-model image understanding)

Lets a main model that cannot see images use a multimodal model to analyze error screenshots, implement UI from design mockups, and inspect bug-report screenshots.

Install

npx -y @kairyou/agent-tools@latest vision -a claude codex opencode

Uninstalling keeps your vision provider config by default.

Configure

~/.agent-tools/config.jsonc is the only config entry point:

{
  "vision": {
    "provider": "openai-compatible",       // or "anthropic-compatible"
    "baseUrl": "https://gateway.example.com/v1",  // anthropic-compatible: gateway root, /v1/messages is appended
    "model": "internal-vlm",
    "apiKey": { "env": "OPENAI_API_KEY" }  // read from the OPENAI_API_KEY environment variable
    // , "timeoutMs": 30000, "maxImageBytes": 20971520, "maxOutputTokens": 8192
    // , "maxConcurrentRequests": 2, "maxRequestsPerMinute": 30
  }
}

apiKey can be a key string such as "apiKey": "sk-...", or an environment variable reference such as { "env": "OPENAI_API_KEY" }. Omit it if your gateway requires no key. Prefer an environment variable to avoid storing the key in the config file.

Use

Pass a local image path or URL in your message. If the main model cannot accept pasted images, save the image first and pass its file path instead.

To diagnose the provider setup or test recognition quality manually:

npx -y @kairyou/agent-tools@latest inspect-image <path|url> -q "What are the navbar background color and height?"

Run from Git

To run directly from the repository, replace the npm package name with github:kairyou/agent-tools (Git required):

npx -y github:kairyou/agent-tools usage -a codex

Contributors can see the repository structure.

FAQ

Why does global installation fail for PromptScript?

PromptScript does not support global skill installation means that the PromptScript agent does not support global installation. It does not affect other agents and can be ignored. See skills issue #1352.

Acknowledgements

• at-commit draws on commit-message generation ideas from OpenCommit and GitLens, reimplemented for an Agent Skill workflow.
• at-review and at-simplify draw on the corresponding workflows in claude-code-system-prompts.