Skip to main content
Reference

Built-in Tools

CogTog includes 73+ built-in tools that agents can use to interact with your system, files, and the web.

Tool Categories

Computer Use

screenshot

computer_use

Captures screenshots with auto-scaling, grid overlay for precise clicking, and multi-monitor support.

fullScreen
region
grid
activeWindow

mouse_click / click_grid

computer_use

Click at screen coordinates or grid cells (A1-H6 format). Supports left, right, middle button and double-click.

x, y
cell
button
doubleClick

mouse_move / mouse_drag / mouse_scroll

computer_use

Move mouse cursor, drag between coordinates, or scroll at current/specified position.

keyboard_type / keyboard_key / keyboard_hotkey

computer_use

Type text, press special keys (Enter, Tab, arrows, F1-F12), or execute keyboard shortcuts (Ctrl+C, etc.).

text
key
modifiers
delay

get_windows / focus_window / list_monitors

computer_use

List all open windows, focus a specific window by title/process, or list connected monitors.

File Operations

read_file

file_system

Read file contents with support for different encodings (utf8, base64, binary) and size limits.

path
encoding
maxSize

write_file

file_system

Write content to file. Creates file if it doesn't exist, optionally appends and creates parent directories.

path
content
append

edit_file

file_system

Make targeted edits by replacing specific text. More efficient than rewriting entire files. Must read file first.

path
old_string
new_string
replace_all

search_files / grep_files

file_system

Search for files by pattern or search file contents. Supports glob patterns, regex, and context lines.

directory
pattern
searchText
contextLines

copy_file / move_file / delete_file

file_system

Copy, move/rename, or delete files and directories with recursive options.

Directory Operations

list_directory

file_system

List files and directories with optional recursion and hidden file inclusion.

path
recursive
includeHidden

create_directory / file_exists

file_system

Create directories (with parent creation) or check if files/directories exist.

Command Execution

run_command

dangerous

Execute shell commands and return output. Set detach=true for GUI apps that shouldn't block.

command
cwd
timeout
detach

run_script

dangerous

Execute script files with specified interpreter (bash, python, node, etc.).

path
args
interpreter

Web & HTTP

http_request

system

Make HTTP requests with full control over method, headers, body, and redirects.

url
method
headers
body

fetch_url

system

Simple URL fetcher. Optionally parses HTML to extract text content.

url
parseHtml

Memory & Context

remember / recall / search_memory

memory

Store and retrieve memories using vector similarity search. Memories persist across sessions.

content
type
importance
query

set_shared_memory / get_shared_memory

system

Share data between agents in the current session. Useful for coordination and handoffs.

add_discovery / add_note / report_blocker

system

Record discoveries, personal notes, or report blockers to the orchestrator.

Agent Communication

message_agent / query_agents

system

Send direct messages to specific agents or query all agents for information.

request_help / ask_user

system

Request help from another agent or ask the user for clarification/input.

capability
question
inputType

task_complete

system

Signal task completion with a summary. Agents MUST call this when finished.

summary
success

System & Database

get_system_info / list_processes / kill_process

system

Get OS, CPU, memory info, list running processes, or terminate processes.

sql_query / list_database_connections

system

Execute SQL queries against configured databases (PostgreSQL, MySQL, SQLite, MSSQL).

connectionId
query
timeout

get_clipboard / set_clipboard

clipboard

Get or set clipboard content (text, HTML, or image).

Advanced Orchestration

Additional tools for workflow automation, service creation, git worktrees, and dynamic task management.

Workflows

create_workflow, run_workflow, list_workflows

Services

create_service, trigger_service, toggle_service

Git Worktrees

create_worktree, list_worktrees, switch_worktree

Tasks

create_task, update_task, get_session_context

Utility Tools

wait / wait_for_condition

system

Wait for a specific time or poll until a condition is met (file exists, process running, etc.).

ms
conditionType
timeout

list_tools

system

List all available tools with descriptions. Agents use this to discover capabilities.

category
search
detailed

Learn More