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 in v0.7.2

Wintool — Windows GUI Automation (new tool)

• 14 operations: list, tree, find, inspect, screenshot, gettext, settext, click, type, send, show, move, close, focus
• Find and enumerate windows and child controls by title, class, or PID
• Capture window screenshots as PNG (saved to temp file, viewable by multimodal agents via Read)
• Read/set text on controls (WM_GETTEXT/WM_SETTEXT)
• Click, type text (with Unicode surrogate pair support), send raw Win32 messages
• Show/hide/minimize/maximize, move/resize, close, focus windows
• Dangerous messages blocked (WM_QUIT, WM_COPYDATA, WM_ENDSESSION)
• Pure syscall, no CGO, Windows only
• Note: apps with DRM/overlay protection may return black screenshots (Windows-level restriction)

Debug — resolve_address operation

• Map any runtime address to its containing module + offset
• Example: 0x7FFE5488 → ntdll.dll+0x5488 (base: 0x7FFE0000, size: 0x1F0000)
• Automatically fetches all modules via DAP and matches address ranges
• Supports common AddressRange formats: base-end, base[size]

Edit — Improved indentation matching

• Added brute-force indent size fallback (tries 2, 3, 4, 8) when auto-detection fails
• Fixes matching failures on deeply nested files (6-7 tab levels) where LLM uses a different indent size
• Also handles reverse case (file uses spaces, LLM sends tabs)

Tool count: 46 → 47