# Available Tools

AnchorCli provides a comprehensive set of tools for file operations, editing, directory management, and command execution.

## File Operations

| Tool | Description |
|------|-------------|
| `read_file` | Read a file (or a window) with Hashline-tagged lines |
| `grep_file` | Search a file by regex — results are pre-tagged for immediate editing |
| `grep_recursive` | Search for a regex pattern across all files in a directory tree |
| `find_files` | Search for files matching glob patterns |
| `get_file_info` | Get detailed file information (size, permissions, etc.) |

## Edit Operations

| Tool | Description |
|------|-------------|
| `replace_lines` | Replace a range identified by `line:hash` anchors |
| `insert_after` | Insert lines after an anchor |
| `delete_range` | Delete a range between two anchors |
| `create_file` | Create a new file with optional initial content |
| `delete_file` | Delete a file permanently |
| `rename_file` | Rename or move a file |
| `copy_file` | Copy a file to a new location |
| `append_to_file` | Append lines to the end of a file |
| `batch_edit` | Apply multiple replace/delete operations atomically in a single call |

## Directory Operations

| Tool | Description |
|------|-------------|
| `list_dir` | List directory contents |
| `create_dir` | Create a new directory (with parent directories) |
| `rename_dir` | Rename or move a directory |
| `delete_dir` | Delete a directory and all its contents |

## Command Execution

| Tool | Description |
|------|-------------|
| `execute_command` | Run shell commands (with user approval) |

## Tool Usage Guidelines

- All file editing tools use **Hashline anchors** (`line:hash`) for precise, safe edits
- Before any mutation, both the line number **and** hash are validated — stale anchors are rejected
- `batch_edit` is preferred for multiple operations to prevent line drift
- `grep_file` results are pre-tagged with anchors for immediate editing

---

*For more details on the Hashline technique, see [HASHLINE.md](HASHLINE.md)*