README file from
GithubAuto folder tags
Automatically apply configured tags to new notes and supplement tags for files in the current folder.
Features
- Listen for newly created markdown files and inject configured frontmatter tags.
- Apply the same configured tags to all markdown files in the current folder from the command palette.
- Avoid duplicate tags when the note already contains some or all target tags.
Installation
Manual install
- Download
manifest.jsonandmain.jsfrom the latest GitHub release. - Create the folder
.obsidian/plugins/auto-folder-tags/inside your vault. - Move the release files into that folder.
- Reload Obsidian and enable Auto folder tags in Settings -> Community plugins.
Community plugins
After the plugin is approved by the Obsidian team, it will be installable from the in-app community plugins browser.
Configuration
- Open Settings -> Community plugins -> Auto folder tags.
- Add one or more rules.
- Set each folder path relative to the vault root, for example
InboxorProjects/ClientA. - Enter tags as comma-separated values, for example
tag1, tag2.
The plugin uses the longest matching folder rule. A rule for Projects/ClientA overrides a broader rule for Projects.
Commands
Apply configured tags to files in the current folderOpen auto folder tags settings
Privacy and disclosures
- The plugin works locally inside the vault.
- It does not send note content, filenames, or telemetry to external services.
- It does not require any cloud account or network access for normal operation.
Development
- Run
npm install - Run
npm run check - Run
npm run devwhile developing - Run
npm run buildfor a production bundle
Release and submission
- The repository includes GitHub Actions for CI and release asset uploads under
.github/workflows/. - The release workflow also generates GitHub artifact attestations for the uploaded release assets.
- The submission helper files live in
submission/. - Release tags must exactly match
manifest.jsonversion, for example0.0.1.
Sandbox preview
The preview helper defaults to the Obsidian Sandbox vault under %APPDATA%.
node preview-in-sandbox.js --enable-plugin
Use a different vault only when needed:
node preview-in-sandbox.js --vault-path "D:\\My Vault"