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.0

DAP Debug Tool

Interactive debugger via Debug Adapter Protocol (DAP). Full DAP coverage including breakpoints (source/function/data/instruction/exception), stepping (forward/backward), variable inspection and modification, expression evaluation, disassembly, memory read/write, stack traces, modules, goto, and completions.

Tested with dlv (Go), debugpy (Python), codelldb (C/C++/Rust). Works with any DAP-compatible adapter. Supports both stdio and TCP modes.

Includes native vsdbg handshake signing (UNSTABLE) — for research and reverse engineering purposes.

Static Binary Analysis Tool (Analyze)

New analyze tool for offline binary analysis without executing the target:

• disassemble: x86/x64 disassembly with Intel syntax, base address support
• pe_info: PE header parsing — sections, imports, exports, RVA-to-file-offset conversion
• strings: Extract printable ASCII and UTF-8 strings from binaries
• hexdump: Standard hex+ASCII dump of any file region

Pure Go implementation (golang.org/x/arch) — no external tools needed.

Copy Tool: Windows Locked-File Fallback

When copying over a running executable or loaded DLL on Windows, the copy tool now automatically renames the locked file aside (with a random suffix) and places the new file at the original path. The agent is notified of the rename via a WARNING in the output.

VS Code DAP Capability Matching

The debug tool now sends a full VS Code-compatible capability set during DAP initialization, fixing compatibility issues with adapters that fingerprint client capabilities.