KeyValue icon

KeyValue

Store and retrieve key-value pairs on the filesystem

Actions20

Vault → Recent

AI-generated

Summary

List recently modified files in the vault, optionally filtered by directory glob pattern and frontmatter tag.

Inputs

  • Limit — Maximum number of results to return, between 1 and 100, default 50.
  • Directory Filter — Glob pattern to restrict which directories to scan (e.g. 'conventions/*'). Leave empty to scan all directories.
  • Tag Filter — Only include files whose frontmatter tags contain this value. Leave empty to include all files.

Output shape

a list of JSON objects, each representing a file with properties: directory (string), key (filename string), updated (ISO timestamp string), size (number of bytes), and optionally tags (array of strings) if present.

Results are sorted by modification time descending, limited by the specified Limit parameter. Files that do not meet the directory or tag filters are excluded. If the vault directory does not exist, no results are returned.

Examples

Example 1: Retrieve the 10 most recent files from all directories.

Set Limit to 10, leave Directory Filter and Tag Filter empty.

Example 2: Retrieve up to 25 recent files from directories matching 'projects/*' tagged with 'n8n'.

Set Limit to 25, Directory Filter to 'projects/*', Tag Filter to 'n8n'.

Links

Discussion