Core tools
These are the day-to-day tools for reading files, running commands, and working with code and repositories.
#Filesystem
| Tool | Description |
|---|---|
read_file | Read file contents with optional line range |
write_file | Write or overwrite a file |
create_file | Create a new file |
edit_file | Apply a targeted string replacement edit to an existing file |
delete_file | Delete a file |
list_dir | List directory contents |
send_file | Send a file to the user (Telegram or API channel) |
approve_scope | Approve a filesystem path for read or write access |
find_files | Advanced file finder — search by glob pattern, content keyword, file type, date range, and size. Recurses up to depth 6, skips node_modules/.git/dist. |
#Document Readers
| Tool | Description |
|---|---|
read_pdf | Extract text, page count, and metadata from a PDF file |
read_excel | Read an Excel / CSV file and render as a markdown table or JSON (supports .xlsx, .xls, .ods, .csv) |
write_excel | Create an .xlsx file from provided rows and headers, with auto-sized columns and bold header row |
read_docx | Extract plain text or HTML from a Word .docx file |
All document tools use permission-gated filesystem access and dynamic imports — tota starts normally even without the optional packages installed.
#Shell
| Tool | Description |
|---|---|
run_command | Run a shell command with timeout and output capture |
cd | Change the working directory |
approve_command | Approve a shell command pattern for the current session |
#Code Sandbox
| Tool | Description |
|---|---|
run_code | Execute a code snippet in an isolated sandbox. Supports Python, JavaScript (Node.js), Bash, TypeScript, Ruby, and Go. Output capped at 8,000 chars. |
Sandbox is isolated from your working directory — use run_command for in-project commands.
#Git
| Tool | Description |
|---|---|
git_status | Show working tree status |
git_diff | Show diffs (staged, unstaged, or between refs) |
git_log | Show commit history |
git_commit | Stage and commit changes with a message |
git_add | Stage files |
git_push | Push commits to remote |
#GitHub
| Tool | Description |
|---|---|
create_pr | Create a pull request |
review_pr | Read PR diff and post a review |
list_issues | List open issues with filters |
create_issue | Open a new issue |
github_api | Raw call to any GitHub REST endpoint |