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
*.tsor**/*.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"