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 project's CLAUDE.md or AGENTS.md so your agent prefers agent-tool over built-in tools:

Strict mode (for projects with non-UTF-8 files or mixed indentation):

ALWAYS use agent-tool MCP tools (mcp__agent-tool__*) instead of built-in file tools.
Do NOT use built-in Read, Edit, Write, Grep, or Glob — use mcp__agent-tool__read,
mcp__agent-tool__edit, mcp__agent-tool__write, mcp__agent-tool__grep, mcp__agent-tool__glob instead.

Soft mode (general projects):

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

What's New

New Tools

• httpreq — Execute HTTP requests (GET/POST/PUT/PATCH/DELETE/HEAD/OPTIONS) with custom headers, body, and proxy support. SSRF protection, ECH + DoH enabled by default.
• jsonquery — Query JSON files with dot-notation paths (dependencies.react, items[0].name, items[*].id) without loading the entire file into context. Saves tokens.
• portcheck — Check if a TCP port is open on a host with response time measurement.
• externalip — Get your external IPv4/IPv6 address.

PowerShell 5.1 Chain Operator Fix

• Fixed: && and || operators caused the bash tool to hang on Windows PowerShell 5.1 (which doesn't support pipeline chain operators). Commands with &&/|| are now auto-transformed to PowerShell equivalents.
• Tokenizer: Quote-aware chain operator parser with $() and () paren depth tracking — correctly handles nested command substitutions, subshells, and arithmetic expansions.
• Delegation: Commands with grouped chains like (cmd1 && cmd2) || cmd3 or $(cmd && cmd) are delegated to git-bash (preferred) or cmd.exe as fallback.
• Warnings: PowerShell 5.1 sessions now emit warnings advising agents to use ; instead of &&/||.
• 31 unit tests covering all edge cases (quotes, escaping, nesting, unmatched parens).

Other Fixes

• claude mcp install: Fixed stdin blocking issue that could cause claude mcp add to hang.