A workspace is a folder that NodeTool can safely access for reading and writing files during workflow runs, agent tasks, and chat sessions.
Why workspaces exist
Workspaces make local file access explicit and controlled:
- Keep project files organized under known roots
- Limit file operations to approved directories
- Share the same folder roots across workflows and agent tools
Manage workspaces in the app
- Open Settings in the NodeTool desktop app.
- Go to the Workspaces tab.
- Add one or more workspace directories.
After adding a workspace, NodeTool can browse files, list folders, and read/write files inside the configured root.
Where workspaces are used
- Agents and chat tools for file operations
- Workflow nodes in the
nodetool.workspacenamespace - Project organization when working with local assets and generated outputs