Built in Tools

Learn how Kodezi CLI’s built-in tools work, including file operations, directory search, command execution, networking, and code intelligence.

Kodezi CLI comes with a collection of built-in tools that allow Chronos-1 to read, modify, search, and interact with your project. These tools perform essential development tasks while ensuring safety through permissions.

Each tool serves a specific purpose and enhances the AI's ability to understand and work with your codebase.

File Operations

View Tool — Read File Contents

The View Tool allows the AI to read file content so it can understand your code before performing actions.

What it can do:

  • Read entire files or specific line ranges
  • Automatically add line numbering
  • Identify binary files
  • Use LSP for better code understanding

Examples:

"Show me the contents of src/app.ts"
"Read lines 10–50 from config.json"

Write Tool — Create or Overwrite Files

The Write Tool is used to generate new files or replace existing ones.

What it can do:

  • Automatically create directories
  • Validate file paths
  • Check permissions before writing
  • Track changes for history

Examples:

"Create a new README.md file"
"Write a test file for the auth module"

Edit Tool — Update Existing Files

The Edit Tool updates specific content inside existing files without overwriting the whole file.

What it can do:

  • Perform search-and-replace
  • Remove content using regex
  • Replace all or only the first occurrence
  • Maintain formatting

Examples:

"Replace 'oldValue' with 'newValue' in config.ts"
"Delete all console.log statements"

Multi-Edit Tool — Apply Multiple Changes

Used for large modifications or making multiple updates at once.

What it can do:

  • Insert, update, or delete content
  • Target specific line numbers
  • Perform batch changes
  • Execute atomic operations without breaking files

Example:

"Add imports at line 1 and update the function at line 50"

Directory Operations

List Tool — Explore Directory Structure

The List Tool helps the AI understand your project’s layout.

Capabilities:

  • Recursively browse folders
  • Display file metadata
  • Generate tree-style output
  • Limit depth for large projects

Examples:

"List all files in src/"
"Show the directory structure"

Glob Tool — Find Files by Pattern

The Glob Tool searches for files using wildcard patterns.

Capabilities:

  • Uses ripgrep for fast searching
  • Supports patterns like *.ts or **/*.json
  • Automatically ignores files excluded by .gitignore
  • Finds files across nested folders

Examples:

"Find all TypeScript files"
"List all .json config files"

Grep Tool — Search Inside Files

The Grep Tool finds specific strings or patterns in file content.

Capabilities:

  • Full regex support
  • Show lines before/after matches
  • Filter search by file types
  • Extremely fast with ripgrep backend

Examples:

"Find all TODO comments"
"Search for function definitions"

Command Execution

Bash Tool — Run Shell Commands

The Bash Tool allows Chronos-1 to perform tasks in your terminal.

Capabilities:

  • Access to the full shell environment
  • Live output streaming
  • Works inside any directory
  • Supports timeouts for long processes
  • Tracks command attribution

Examples:

"Run the test suite"
"Install npm dependencies"
"Build the project"

Permission Required

Shell commands require manual approval unless auto-approval is enabled.

Network Operations

Fetch Tool — Make HTTP Requests

Used when the AI needs to retrieve API data or interact with external services.

Capabilities:

  • Supports GET, POST, PUT, DELETE
  • Custom headers and request bodies
  • Timeout and error handling
  • Pretty-printed response formatting

Examples:

"Fetch the API documentation from https://api.example.com/docs"
"Make a POST request to the webhook"

Download Tool — Save External Files

The Download Tool fetches files directly from URLs.

Capabilities:

  • Automatic file naming
  • Download progress tracking
  • Timeout settings
  • Permission checks

Example:

"Download the latest release from GitHub"

Code Intelligence

Diagnostics Tool — LSP-Based Code Analysis

The Diagnostics Tool checks your code for errors and warnings.

Capabilities:

  • Real-time error detection
  • LSP-powered suggestions
  • Multi-language support
  • File-level or project-level scanning

Examples:

"Check for errors in app.ts"
"Show me all warnings in the codebase"