MeshiaDocs
All docsPricing
Continue
All docs
Getting started
Your first sessionThe workspaceSSH access
Core concepts
Agent rolesSoon
ExperimentsResearch plans
CanvasSoon
WorkflowsSoon
Integrations
GitHub
WebhooksSoon
Notifications
Platform
Billing and plansAgent memoryMulti-chatKeyboard shortcuts
Reference
GPU catalogAgent toolsSecurityLimits and quotas
Reference

Agent tools

Overview

The in-pod agent has access to 55+ tools for interacting with the pod, your code, and the Meshia platform. Tools are grouped by category.

Filesystem

ToolDescription
read_fileRead a file's contents
write_fileCreate or overwrite a file
edit_fileMake targeted edits to an existing file
list_directoryList files and folders in a directory
search_filesSearch file contents with regex
glob_filesFind files matching a glob pattern
delete_fileDelete a file (with confirmation)
move_fileMove or rename a file
file_infoGet file size, permissions, modification time

Shell and execution

ToolDescription
bashRun a shell command and return output
pythonExecute a Python snippet
background_taskRun a long command in the background
kill_processStop a running background process
list_processesShow running and background processes

Git

ToolDescription
git_statusShow working tree status
git_diffShow file diffs
git_commitStage and commit changes
git_branchCreate or switch branches
git_pushPush commits to remote
git_pullPull latest from remote
git_logShow commit history
create_prOpen a GitHub pull request

Experiments

ToolDescription
log_metricLog a metric value at a step
log_artifactSave a file as an experiment artifact
create_experimentStart a new tracked experiment
end_experimentMark an experiment as complete
list_experimentsList experiments in the session
compare_experimentsGenerate a comparison of two or more runs

Data

ToolDescription
download_urlDownload a file from a URL
download_hf_datasetDownload a Hugging Face dataset
download_hf_modelDownload a Hugging Face model
upload_artifactUpload a file to Meshia storage

Environment

ToolDescription
pip_installInstall Python packages
conda_installInstall packages via conda
gpu_statusGet GPU utilization, VRAM, temperature
system_infoGet CPU, RAM, disk, OS details
env_varSet an environment variable

UI and canvas

ToolDescription
canvas_addAdd an element to the canvas
canvas_updateUpdate an existing canvas element
canvas_removeRemove a canvas element
render_chartGenerate a chart from data
render_pie_chartGenerate a pie or donut breakdown from category data
render_gpu_partitionShow GPU pod slots grouped by workload
render_tableGenerate a sortable table
render_diffShow a side-by-side diff
show_imageDisplay an image from the pod

Research

ToolDescription
search_papersSearch Semantic Scholar for papers
read_paperDownload and extract text from a paper
create_planBuild a research plan
update_planModify an existing plan step
memory_storeSave a fact to agent memory
memory_recallRetrieve relevant memories

Communication

ToolDescription
notify_userSend a notification (email or in-app)
post_blackboardPost a message to the session blackboard
read_blackboardRead recent blackboard posts

This isn't exhaustive, the agent has additional internal tools for coordination and planning. But these are the ones you'll see referenced in logs and can ask the agent about directly.

← GPU catalogSecurity →