knewstimek/agent-tool

Quick Start

1. Download the binary for your OS below
2. Run agent-tool install (or agent-tool install claude)
3. Restart your IDE
4. Done -- all tools work immediately, no permission popups

Or just ask your AI agent:

"Download agent-tool from https://github.com/knewstimek/agent-tool/releases/latest and run agent-tool install"

Any capable AI coding agent (Claude Code, Codex, etc.) can handle the full download -> install -> restart flow automatically.

Tip: Add this to your CLAUDE.md or AGENTS.md so your agent prefers agent-tool over built-in tools:

Strict mode:

ALWAYS use agent-tool MCP tools (mcp__agent-tool__*) instead of built-in file tools. agent-tool preserves file encoding and respects .editorconfig indentation settings.

Soft mode:

Prefer agent-tool MCP tools (mcp__agent-tool__*) over built-in file tools when available.

What's New

New tool: multiedit

Applies multiple old_string -> new_string edits to a single file in one atomic call. If any edit fails, the file is left unchanged. Supports dry_run, path alias, encoding-aware (preserves EUC-KR, Shift-JIS, etc.).

String param compatibility (FlexBool + FlexInt)

Claude Code serializes tool parameters as strings when using the XML tool call format ("true" instead of true, "5" instead of 5). go-sdk's strict schema validation was rejecting these, causing silent failures. All bool and int input fields now accept both proper JSON types and string representations.

• 35+ bool fields covered: dry_run, replace_all, overwrite, relative_paths, skip_blank, ignore_case, tree, background, disconnect, no_doh, no_ech, use_agent, recursive, tls, post, raw, stop_at_ret, include_zombies, resolve_symbols, and more
• 40+ int fields covered: limit, offset, max_results, max_depth, context, port, timeout_sec, pid, count, length, mode, db, workers, depth, context_lines, and more
• Shared helpers common.FlexBool() and common.FlexInt() added

Path alias: all file tools

All file tools now accept both file_path and path interchangeably -- no more validation errors when an agent uses the wrong parameter name.

• file_path-primary tools (edit, write, patch, checksum, delete, file_info, convert_encoding, jsonquery, tomlquery, yamlquery, analyze) now also accept path
• path-primary tools (grep, listdir, mkdir, sloc, regexreplace) now also accept file_path

Other fixes

• read actionable error for long lines: files with lines >64KB (minified JS, single-line JSON, binary) previously returned empty content silently. Now returns a clear error with suggestions: use analyze for binary, download for minified, grep for targeted search.
• omitempty on bool fields: delete.dry_run, mkdir.dry_run, rename.dry_run, sloc.skip_blank were incorrectly required in JSON schema -- fixed.
• README: added settings.json deny list tip for forcing agents to prefer agent-tool over Claude Code's built-in file tools.

Full Changelog: https://github.com/knewstimek/agent-tool/compare/v0.8.3...v0.8.4