Namespaces
August 12, 2025 · View on GitHub
Nerve offers a rich set of predefined tools, organized in namespaces, that the agent can import via the using directive. This page contains the list of namespaces available in Nerve, with the descriptive prompt that will be provided to the model.
Note
The jail directive can restrict filesystem and filesystem_w namespaces to specific paths:
jail:
filesystem: ["/allowed/path", "/another/allowed/path"]
filesystem_w: ["/writable/path", "{{ dynamic_path }}"]
Variables can be used in jail paths for dynamic configuration.
🔧 anytool
Let the agent create its own tools in Python.
Show Tools
create_tool
Create a new tool or redefine an existing one by defining it as an annotated Python function.
Use this tool to implement the missing functionalities you need to perform your task.
Parameters
code(<class 'str'>): The Python code to create the tool.
💻 computer
Important
This namespace is not available by default and requires the computer_use optional feature.
To enable it, run pip install nerve-adk[computer_use].
Computer use primitives for mouse, keyboard, and screen.
Show Tools
get_cursor_position
Get the current mouse position.
keyboard_press_hotkeys
Press one or more hotkeys on the keyboard.
Parameters
keys(<class 'str'>): The hotkey sequence to press (like 'ctrl+shift+cmd+space')
keyboard_type
Type the given text on the keyboard.
Parameters
text(<class 'str'>): The text to type
mouse_double_click
Double click the left mouse button at the current mouse position.
mouse_left_click
Click the left mouse button at the current mouse position.
mouse_left_click_drag
Click and drag the left mouse button from the current mouse position to the given coordinates.
Parameters
x(<class 'int'>): The x coordinate to move toy(<class 'int'>): The y coordinate to move to
mouse_middle_click
Click the middle mouse button at the current mouse position.
mouse_move
Move the mouse to the given coordinates.
Parameters
x(<class 'int'>): The x coordinate to move toy(<class 'int'>): The y coordinate to move to
mouse_right_click
Click the right mouse button at the current mouse position.
mouse_scroll
Scroll the mouse wheel in the given direction.
Parameters
x(<class 'int'>): The x coordinate to move toy(<class 'int'>): The y coordinate to move to
screenshot
Take a screenshot of the current screen.
📂 filesystem
Read-only access primitives to the local filesystem.
Jail
The tools in this namespace can be restricted to a specific set of paths by using the jail directive in the agent configuration:
using:
- filesystem
jail:
filesystem:
- "/only/path/to/allow"
- "{{ target_path }}" # variables can be used too
Show Tools
list_folder_contents
List the contents of a folder on disk.
Parameters
path(<class 'str'>): The path to the folder to list
read_file
Read the contents of a file from disk.
Parameters
path(<class 'str'>): The path to the file to read
📂 filesystem_w
Write primitives to the local filesystem.
Jail
The tools in this namespace can be restricted to a specific set of paths by using the jail directive in the agent configuration:
using:
- filesystem_w
jail:
filesystem_w:
- "/only/path/to/allow"
- "{{ target_path }}" # variables can be used too
Show Tools
create_file
Create a file on disk, if the file already exists, it will be overwritten.
Parameters
path(<class 'str'>): The path to the file to createcontent(str | None): The content to write to the file, if not provided, the file will be created empty
delete_file
Delete a file from disk.
Parameters
path(<class 'str'>): The path to the file to delete
💬 inquire
Let the agent interactively ask questions to the user in a structured way.
Show Tools
ask_for_confirmation
Ask a confirmation question to the user.
Parameters
question(<class 'str'>): The question to ask the user.default(<class 'bool'>): The default answer to the question.
ask_for_multiple_choice
Ask a multiple choice question to the user.
Parameters
question(<class 'str'>): The question to ask the user.choices(list[str]): The choices to offer the user.
ask_for_single_choice
Ask a single choice question to the user.
Parameters
question(<class 'str'>): The question to ask the user.choices(list[str]): The choices to offer the user.
ask_question
Ask a question to the user.
Parameters
question(<class 'str'>): The question to ask the user.
🧠 reasoning
Simulates the reasoning process at runtime.
Show Tools
clear_thoughts
If the reasoning process proved wrong, inconsistent or ineffective, clear your thoughts and start again.
think
Adhere strictly to this reasoning framework, ensuring thoroughness, precision, and logical rigor.
## Problem Decomposition
Break the query into discrete, sequential steps.
Explicitly state assumptions and context.
## Stepwise Analysis
Address each step individually.
Explain the rationale, principles, or rules applied (e.g., mathematical laws, linguistic conventions).
Use examples, analogies, or intermediate calculations to illustrate reasoning.
## Validation & Error Checking
Verify logical consistency at each step.
Flag potential oversights, contradictions, or edge cases.
Confirm numerical accuracy (e.g., recompute calculations).
## Synthesis & Conclusion
Integrate validated steps into a coherent solution.
Summarize key insights and ensure the conclusion directly addresses the original query.
Parameters
thought(<class 'str'>): A thought to think about
💻 shell
Let the agent execute shell commands.
Warning
Using this tool will bypass the filesystem jail mechanism
Tip
The default timeout for shell commands is 60 seconds. You can override this value by setting the NERVE_SHELL_TIMEOUT environment variable.
Show Tools
shell
Execute a shell command on the local computer and return the output. Non interactive shell with a timeout of 60 seconds.
Parameters
command(<class 'str'>): The shell command to execute
✅ task
Let the agent autonomously set the task as complete or failed.
Show Tools
task_complete_success
When your objective has been reached use this tool to set the task as complete.
Parameters
reason(str | None): Optional reason why the task is complete or report of conclusive information.
task_failed
Use this tool if you determine that the given goal or task is impossible given the information you have.
Parameters
reason(<class 'str'>): The reason why the task is impossible
🕒 time
Provides tools for getting the current date and time and waiting for a given number of seconds.
Show Tools
current_time_and_date
Get the current date and time.
wait
Wait for a given number of seconds.
Parameters
seconds(<class 'int'>): The number of seconds to wait