Integrated Tools

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:

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

Plugins can register additional tools and categories. See Plugin Overview.

Tool list

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.

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.

Getting started

User guides

Plugin development

Reference

Integrated Tools

How Nagare finds tools

Tool list

Process management (`process_management`)

Filesystem (`filesystem`)

System

Information and lookup

Scheduled jobs (`cronjob_management`)

Tool approval

​How Nagare finds tools

​Tool list

​Process management (process_management)

​Filesystem (filesystem)

​System

​Information and lookup

​Scheduled jobs (cronjob_management)

​Tool approval

How Nagare finds tools

Tool list

Process management (`process_management`)

Filesystem (`filesystem`)

System

Information and lookup

Scheduled jobs (`cronjob_management`)

Tool approval