Tools Reference

Complete guide to CLIO's built-in tools

CLIO provides 9 powerful tools for interacting with your system. Each tool is operation-based with multiple capabilities.

1. file_operations

Purpose: File and directory management

Operations:

• read_file - Read file content with optional line ranges
• write_file - Overwrite existing file
• create_file - Create new file with content
• append_file - Append content to file
• replace_string - Find and replace text
• multi_replace_string - Batch replace operations
• insert_at_line - Insert content at specific line
• delete_file - Delete file or directory
• rename_file - Rename or move file
• list_dir - List directory contents
• file_exists - Check if file exists
• file_search - Find files matching pattern
• grep_search - Search file contents with regex
• semantic_search - Keyword-based relevance search

2. version_control

Purpose: Git version control operations

Operations:

• status - Repository status and changes
• diff - Show differences between commits/branches
• log - Git commit history
• commit - Create commits
• branch - Branch operations (list, create, switch, delete)
• push - Push changes to remote
• pull - Pull changes from remote
• stash - Stash operations (save, list, apply, drop)
• tag - Tag operations (list, create, delete)
• blame - Show file annotation

3. terminal_operations

Purpose: Execute shell commands

Operations:

• exec - Run command and capture output
• validate - Check command safety before execution

4. memory_operations

Purpose: Store and recall information across sessions

Session Memory:

• store - Store key-value pairs
• retrieve - Get stored information
• search - Find memories by keyword
• list - List all memory keys
• delete - Remove stored memory

Long-Term Memory (LTM):

• recall_sessions - Search previous session history
• add_discovery - Store discovered facts
• add_solution - Store problem-solution pairs
• add_pattern - Store code/workflow patterns
• prune_ltm - Remove old/low-confidence entries
• ltm_stats - Get LTM statistics

5. todo_operations

Purpose: Manage structured task lists

Operations:

• read - Get current todo list
• write - Create/replace entire list
• update - Change status of existing todos
• add - Append new todos

6. web_operations

Purpose: Fetch URLs and search the web

Operations:

• fetch_url - Fetch content from URL
• search_web - Web search (SerpAPI or DuckDuckGo)

7. code_intelligence

Purpose: Code analysis and symbol search

Operations:

• list_usages - Find all references to a symbol

8. user_collaboration

Purpose: Request user input during tasks

Operations:

• request_input - Ask for clarification or decisions

9. remote_execution

Purpose: Execute CLIO tasks on remote systems via SSH

Operations:

• execute_remote - Run CLIO task on remote system
• execute_parallel - Run task on multiple devices
• prepare_remote - Pre-stage CLIO without executing
• cleanup_remote - Remove CLIO from remote
• check_remote - Verify remote connectivity
• transfer_files - Copy files to remote
• retrieve_files - Fetch files from remote

Tool Transparency

When CLIO uses tools, you see real-time notifications:

SYSTEM: [file_operations] - Reading ./config.json (254 lines)
SYSTEM: [version_control] - git status
SYSTEM: [terminal_operations] - Executing: npm install

Next Steps

• Workflows - Learn common usage patterns
• Remote Execution - Use CLIO on remote systems
• Multi-Agent - Parallel AI coordination