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

codegraph -- AST-based code indexing (NEW)

Parses source code with tree-sitter (via WASM) and stores symbols/relationships in a local SQLite index. Enables precise symbol lookup -- no grep noise, no false positives.

Zero external dependencies. Tree-sitter runs as WASM inside the binary via wazero (pure Go WASM runtime). No Python, no Docker, no language servers.

Supported languages: C/C++, Python, Go, C#

Operations:

• index(path) -- Build/update code index for a project directory (incremental)
• find(name) -- Find symbol definitions (function, class, method)
• callers(name) -- Find all call sites of a function/method
• callees(name) -- Find all functions called by a function
• symbols(path) -- List all symbols in a file (no index needed)
• methods(name) -- List all methods of a class

Example:

codegraph(op="index", path="/project/root")     -- build index
codegraph(op="methods", name="Monster")          -- list methods
codegraph(op="callers", name="takeDamage")       -- who calls this?
codegraph(op="callees", name="main")             -- what does main call?

Stats

• 52 tools total (was 51)
• Binary size: ~48MB (was ~23MB, +WASM grammars +SQLite)

Credits

• C++ parser patterns inspired by code-graph-rag (MIT)
• tree-sitter (MIT) -- AST parsing
• wazero (Apache 2.0) -- pure Go WASM runtime
• modernc.org/sqlite (BSD-3) -- pure Go SQLite