Skip to main content
Every agent has access to these built-in tools:

Workspace & Files

ToolDescription
run_shellExecute shell commands in the agent’s workspace
read_fileRead file contents
write_fileWrite or overwrite a file
list_filesList files in a directory
All file paths resolve relative to the agent’s workspace at ~/.operator/agents/<name>/workspace/.

Web

ToolDescription
web_fetchFetch and extract content from a URL

Messaging

ToolDescription
send_messageSend a message to a channel or thread

Sub-agents

ToolDescription
spawn_agentSpawn another agent as a sub-agent

Memory

ToolDescription
save_memoryStore a memory with scope and optional pin
search_memoriesSemantic search across stored memories
forget_memoryDelete a specific memory
list_memoriesList memories with filters

Key-Value Store

ToolDescription
kv_getRetrieve a value by key
kv_setStore a value with optional TTL
kv_deleteRemove a key
kv_listList keys and values
Keys are scoped by agent name and grouped by namespace. Use namespaces to organize related keys (e.g. by job name). Use TTL to auto-expire tracking data.

Job Management

ToolDescription
manage_jobEnable, disable, or trigger jobs

Transport Tools

These tools are available when the agent is connected to a transport:
ToolDescription
list_channelsList available Slack channels with IDs and topics