tools-init

name	tools-init
description	Discover all available CLI tools on this machine and write their full paths to .agents/tools.local.json. Run once per machine or after installing new tools.
disable-model-invocation	true
allowed-tools	Bash(where *) Bash(which *) PowerShell(Get-Command *)

/tools-init

Scan this machine for the known tool list, write a JSON manifest to .agents/tools.local.json, then print a report. The manifest gives every hook and every shell command a verified full path (the block-unlisted-tool hook depends on it).

Steps

1. Detect OS

• Windows: where <tool> (or PowerShell (Get-Command <tool>).Source).
• Linux/WSL: which <tool>.

2. Discover tools

If .agents/tools.local.json already exists: read it, then for every tool re-scan a null path (it may have been installed since) and verify a non-null path still exists on disk (set to null if it no longer resolves).

Tool list to scan (group in parentheses):

unix: cp, diff, du, grep, sed, awk, wget, head, tail, wc, cut, xargs, uniq, unzip, tar, vim, nano, ssh, scp, sftp, ls, cat, mkdir, rmdir, rm, mv, touch, chmod, chown, ln, basename, dirname, env, printenv, which, tr, sort, paste, tee, find, date, sleep, ps, tty, file, zip, gzip, gunzip, more, less, expr, bc, echo, printf, pwd, kill, true, false, type, [, test, bash, sh, dash, zsh

dev: git, node, npm, npx, nvm, python, python3, py, rg, curl, jq, gh, fd, bat, yq, pnpm, mise, java, javac, ffmpeg, code

devops: docker, ollama, kubectl

dotnet: dotnet

agent-cli: claude, opencode, codex, gemini, cn, kilo

windows: clip, ipconfig, pwsh, reg, robocopy, choco, scoop, systeminfo, taskkill, tasklist, where, winget, wmic, wsl, powershell, cmd

db: sqlcmd, bcp, psql, sqlplus, sqlite3, mysql, mongosh, redis-cli

3. Write .agents/tools.local.json

{
  "generated": "YYYY-MM-DD",
  "os": "win32|linux|wsl",
  "tools": { "<tool>": "<full path or null>" }
}

Keep the existing builtin array if present (the Claude Code SDK tools that bypass the path check). A null value means the tool is not installed - do not assume it exists.

4. Ensure it is gitignored

.agents/tools.local.json is machine-specific and must stay in .gitignore. If the entry is missing, add it.

5. Print report

• Found: list tools with non-null paths and their paths.
• Missing: list tools with a null path (tell the user the install source only if you are certain; do not invent install commands).