MORATUS Desktop
The Desktop agent uses the tools below to read and change the files in your folder, produce documents, and run commands. The tools run on your computer, in the local runtime; every tool use appears in the chat as its own step.
Update the Q3 growth report and prepare a short Word summary for leadership.
I'll review the report and the data in the folder and outline a plan first, then apply the updates.
Files listed list_files · 14 files
Data read read_file · q3-data.xlsx · 3 sheets
Report read read_file · growth-report.md · 248 lines
Report updated edit_file · growth-report.md · +36 −12
Summary ready create_document · Q3-leadership-summary.docx
I updated the Q3 numbers: the revenue and active user tables now use the new data, and I removed two outdated paragraphs. The leadership summary is saved in the working folder as Q3-leadership-summary.docx.
Give Desktop a task
Reading
| Tool | What it does |
|---|---|
list_files | Lists the files in a folder. |
read_file | Reads text, code, PDF, Word, and Excel/CSV content; formulas and cell addresses are preserved. |
vision_analysis | Analyzes attached images or images in the folder, together with the text inside them. |
Writing
| Tool | What it does |
|---|---|
write_file | Creates a new file. |
edit_file | Makes targeted changes to an existing file. |
delete_file | Deletes a file or an empty folder. |
Documents
| Tool | What it does |
|---|---|
create_document | Generates Word, Excel, and PDF; changes text in existing .docx files without breaking the formatting; updates cells and formulas in .xlsx, .csv, and .tsv files. |
Commands and the terminal
| Tool | What it does |
|---|---|
run_command | Runs PowerShell commands that finish (tests, builds, git, installs). Default timeout 120 s, up to 600 s. |
terminal_run, terminal_read, terminal_stop | Start, read the output of, and stop long-running processes (development servers, watchers) in the side panel terminal. |
Planning, delegation, and the web
| Tool | What it does |
|---|---|
update_todos | Updates the to-do list for multi-step work (see Plan mode and the to-do list). |
delegate | Hands broad reading work to the worker model (see Brain and worker architecture). |
web_search, read_webpage | Web research: searches and reads pages. |
Which tools ask for approval?
| Kind of tool | Ask for approval | Approve for me | Full access |
|---|---|---|---|
| Reading and web | Asks | Automatic | Automatic |
| Writing and editing files, documents | Asks | Automatic | Automatic |
Deleting files (delete_file) | Asks | Asks | Automatic |
| Terminal commands | Asks | Asks | Automatic |
Command or terminal?
| `run_command` | Terminal tools | |
|---|---|---|
| What for? | Work that finishes: tests, builds, git, installs | Long-running processes: development servers, watchers |
| Duration | Default 120 s, up to 600 s | Until you or the agent stops it |
| Where you see it | As a step in the chat | In the side panel terminal and the ▶/■ button next to the composer |
| Can it be undone? | No; not covered by checkpoints | No; not covered by checkpoints |
Supported file types
| Type | Reading | Creating and editing |
|---|---|---|
| Text and code | read_file | write_file, edit_file |
read_file | A new PDF with create_document | |
| Word (.docx) | read_file | create_document: a new document, or text changes in an existing one without breaking the formatting |
| Excel and spreadsheets (.xlsx, .csv, .tsv) | read_file: formulas and cell addresses are preserved | create_document: a new file, or cell and formula updates |
| Images | vision_analysis | — |
Note
Heavy tool sets aren't sent with every step; they load on demand (read_skill). This lowers token usage (see Agent skills).
Example requests and the tools they use
| Request | Tools used |
|---|---|
| “Summarize the contracts in this folder.” | list_files, read_file |
| “Explain the error in this screenshot.” | vision_analysis |
| “Update the prices in the proposal document.” | read_file, create_document |
| “Run the tests and fix the ones that fail.” | run_command, read_file, edit_file |
| “Start the dev server and tell me its address.” | terminal_run, terminal_read |
| “Research competitors' prices and add them to the spreadsheet.” | web_search, read_webpage, create_document |
Frequently asked questions
- How does the agent decide which tool to use? It plans the steps itself based on your request and the files in your folder; every tool use appears as its own step in the chat, so you can follow what was done and why.
- Will my Excel formulas break? No.
read_filepreserves formulas and cell addresses, andcreate_documentcan update cells and formulas. - Will my Word document's formatting change? In existing .docx files, text is changed without breaking the formatting.