n8n-nodes-folder-management
v0.1.2
Published
Custom n8n node for creating and deleting folders on the worker host
Maintainers
Readme
n8n-folder-management
Community n8n node package that adds a Worker Folder node for safe folder creation and deletion on a worker host filesystem.
Package
- Name:
n8n-nodes-folder-management - Node:
Worker Folder(workerFolder) - Source entrypoint:
nodes/WorkerFolder/WorkerFolder.node.ts - Build output:
dist/nodes/WorkerFolder/WorkerFolder.node.js
Install
npm install n8n-nodes-folder-managementDevelopment
npm ci
npm run lint
npm run buildUseful commands:
npm run devto run the local n8n node development workflownpm run build:watchfor TypeScript watch modenpm run releasefor tag-based local release preparation
Worker Folder behavior and safety
- Operations:
CreateandDelete Folder Pathcan be absolute or relative toWORKER_FOLDERS_BASE_PATH(default/workspace)- Blocks path traversal and any resolved path outside the allowed base path
- Rejects symlink targets and symlink escapes
- Rejects deleting the base path root
- Rejects create/delete against non-directory filesystem targets
- Supports continue-on-fail item output with structured error fields
CI and publish automation
.github/workflows/ci.ymlrunslintandbuildon pull requests andmainpushes.github/workflows/publish.ymlruns onmainpushes and manual dispatch- Publish workflow:
- Installs dependencies, lints, and builds
- Auto-bumps patch version
- Publishes only if that version does not already exist on npm
- Uses npm provenance (
--provenance) with GitHub OIDC support - Falls back to
NPM_TOKENif configured - Commits version bumps (
package.jsonandpackage-lock.json) back tomain
Required repository configuration
- Configure npm trusted publishing (recommended) for this repository, or add
NPM_TOKENsecret. - Keep workflow permissions enabled for
contents: writeandid-token: write. - Ensure GitHub Actions can push to
main(branch protection allowance).
