Tools Reference

AgentiCode includes 14+ built-in tools for common development tasks.

File Operations

read_file

Read file contents with optional line range:

Input:
  path: string (required) - File path
  startLine?: number - Start line (1-indexed)
  endLine?: number - End line

Output: File content with line numbers

write_file

Write or create files:

Input:
  path: string (required) - File path
  content: string (required) - Content to write
  mode?: 'create' | 'overwrite' | 'append'

Output: Confirmation with line count
Note: Creates parent directories automatically

edit_file

Edit specific lines in a file:

Input:
  path: string (required) - File path
  startLine: number (required) - Start line
  endLine: number (required) - End line
  replacement: string (required) - New content

Output: Unified diff showing changes

list_dir

List directory contents:

Input:
  path?: string - Directory path (default: cwd)
  recursive?: boolean - Include subdirectories

Output: File tree with sizes and types

delete_file

Delete a file:

Input:
  path: string (required) - File path

Output: Deletion confirmation

Shell Execution

shell

Execute shell commands:

Input:
  command: string (required) - Command to run
  workDir?: string - Working directory
  timeout?: number - Timeout in seconds (default: 60)

Output: stdout/stderr combined
Security: Blocks dangerous commands (rm -rf /, sudo, etc.)

Search Tools

grep

Search file contents with regex:

Input:
  pattern: string (required) - Regex pattern
  path?: string - Search path (default: cwd)
  filePattern?: string - Glob to filter files
  ignoreCase?: boolean - Case insensitive
  maxResults?: number - Limit results
  context?: number - Lines of context

Output: Matching lines with file:line format
Uses: ripgrep (rg) for performance

glob

Find files by pattern:

Input:
  pattern: string (required) - Glob pattern
  path?: string - Base path

Output: Matching file paths with metadata

Web Tools

web_search

Search the web:

Input:
  query: string (required) - Search query
  maxResults?: number - Number of results

Output: Title, URL, snippet for each result
Provider: DuckDuckGo (no API key needed)

web_fetch

Fetch and parse a URL:

Input:
  url: string (required) - URL to fetch
  timeout?: number - Timeout in seconds

Output: Page content as text/markdown
Cache: 5 minutes

Task Management

todo_write

Manage task list:

Input:
  todos: array (required)
    - content: string - Task description
    - status: 'pending' | 'in_progress' | 'completed'

Output: Updated task list

todo_read

Read current tasks:

Output: Current todos with status

Media Tools

view_image

Display an image in the terminal:

Input:
  path: string (required) - Image path

Output: Image displayed (terminal support required)

screenshot

Take a screenshot:

Output: Screenshot saved to temp file

Background Process Tools

bash_background

Run a command in background:

Input:
  command: string (required) - Command to run
  description?: string - Description

Output: Process ID
Use for: Servers, builds, tests, long-running tasks

bash_output

Get output from background process:

Input:
  processId: string (required) - Process ID
  lines?: number - Number of lines to return

Output: stdout/stderr tail

kill_bash

Terminate a background process:

Input:
  processId: string (required) - Process ID

Output: Termination confirmation

list_background

List active background processes:

Output: Process table with PID, status, uptime

Batch Operations

read_many_files

Read multiple files efficiently:

Input:
  paths: string[] (required) - Array of file paths

Output: Combined file contents
Performance: Optimized for batch reads

apply_patch

Apply a unified diff patch:

Input:
  path: string (required) - Target file
  patch: string (required) - Unified diff content

Output: Patched file content

MCP Tools

When connected to the AgenticWork platform, additional MCP tools are available:

• awp_web: Web search and fetch

• awp_memory: Vector memory storage

• awp_diagram: Diagram generation

• awp_admin: System administration

• awp_azure: Azure operations

• awp_aws: AWS operations

• awp_gcp: GCP operations

• awc_formatting: Content formatting

Tool naming: {server}___{tool} (e.g., awp_web___search)

Security

Blocked Commands

The following patterns are blocked for safety:

• rm -rf /

• sudo (without explicit approval)

• Pipe to shell (| sh, | bash)

• Format commands (mkfs, dd)

• System modification commands

Human-in-the-Loop (HITL)

By default, potentially dangerous operations require confirmation:

• File writes outside working directory

• Shell commands with side effects

• Delete operations

• System commands

Disable with --yolo flag (use with caution).