> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nagare.smtdfc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrated Tools

> List of tools Nagare uses to interact with the system and the approval mechanism before running risky operations.

Tools are actions that Nagare can perform on your machine. You do not need to call tools directly: just describe what you want to do in natural language, and Nagare will choose and call the appropriate tool.

## How Nagare finds tools

Tools are grouped by **category**. Instead of loading every tool into each conversation turn, Nagare uses two routing tools:

1. `find_tool_by_categories`: finds tools belonging to one or more categories.
2. `execute_tool`: calls the found tool by name, with parameters.

Plugins can register additional tools and categories. See [Plugin Overview](https://docs.nagare.smtdfc.net/en/plugins/overview.md).

## Tool list

> [!NOTE]
>
> Tools marked with ✅ in the **Approval** column always ask you before running.

### Process management (`process_management`)

| Tool | Description | Approval |
| - | - | - |
| `list_process_tool` | List processes, filtered by RAM (`min_memory_mb`), CPU (`min_cpu_percent`), name (`name_query`, `exclude_name`), sorted by `ram` or `cpu`, and limited by result count. | |
| `create_process_tool` | Launch a detached process and return the PID. Takes `command`, `args`, and `working_dir`; does not use shell syntax. | ✅ |
| `kill_process_tool` | Terminate a process by PID. | ✅ |

### Filesystem (`filesystem`)

| Tool | Description | Approval |
| - | - | - |
| `get_user_directories_tool` | Get user directories: home, downloads, desktop, documents, temp, config, cache. | |
| `list_directory_tool` | List files and folders at a path. | |
| `read_file_tool` | Read the contents of a text file. | |
| `write_file_tool` | Create or update a text file (`overwrite` to replace). | ✅ |
| `delete_file_tool` | Delete a file. Does not allow deleting directories. | ✅ |

### System

| Tool | Category | Description | Approval |
| - | - | - | - |
| `power_control_tool` | `power_control` | Shut down, restart, suspend, hibernate, or log out. | ✅ |
| `volume_control_tool` | `audio_management` | Set, read, mute/unmute, increase, or decrease volume. | |
| `get_active_display_tool` | `system` | Get the number of active displays. | |
| `screenshot_tool` | `system` | Take a screenshot by index and save a PNG image to the `~/.nagare/artifacts` directory. | |
| `open_browser_tool` | `browser` | Open one or more URLs in the browser. | ✅ |
| `time_tool` | `timing` | Get the current date and time, optionally in a specific time zone. | |

### Information and lookup

| Tool | Category | Description |
| - | - | - |
| `weather_tool` | `weather` | Get current weather (temperature, wind, humidity, weather code) by latitude and longitude. |
| `search_tool` | `research` | Search for information from a source. Currently supports `Wikipedia`. |
| `fetch_content_tool` | `research` | Fetch the full content of a search result by ID. |

### Scheduled jobs (`cronjob_management`)

| Tool | Description |
| - | - |
| `create_cronjob_tool` | Create a cron job that runs a request on a schedule. See [Cron Jobs](https://docs.nagare.smtdfc.net/en/guides/cronjobs.md). |

## Tool approval

For tools that can change the system, Nagare pauses and sends an **approval request** (human-in-the-loop) to the channel you are chatting in:

* **Web / desktop UI**: displays an approval box right in the conversation.
* **Telegram**: sends a message with **Approve / Reject** buttons, or use the `/approve <request-id>` and `/reject <request-id>` commands.

Rules:

* If you do not respond within **5 minutes**, the request expires and the tool is **not** run.
* If no channel receives the approval request, the tool is denied (fail closed) instead of running silently.
* `write_file_tool` and `delete_file_tool` also require the `confirm` parameter to be `true`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.