Function listNotes

listNotes(
    vault: Vault,
    args: {
        folder?: string;
        limit?: number;
        since_date?: string;
        tag?: string;
    },
): Promise<NoteSummary[]>
List markdown notes in the vault, optionally filtered by tag / folder / modification date.

Sorted by mtime descending (most recent first). Cheap metadata view — frontmatter and tags only, no body. Use readNote to fetch the full content for a specific result.
Parameters
- vault: Vault
  The vault to scan.
- args: { folder?: string; limit?: number; since_date?: string; tag?: string }
  All optional. tag matches against both frontmatter and inline tags (normalized — leading # and case ignored). folder restricts to a subdirectory. since_date is an ISO 8601 date (YYYY-MM-DD) — only notes modified at-or-after are returned. limit defaults to 50.
Returns Promise<NoteSummary[]>
A NoteSummary array sorted by mtime desc, truncated to limit.
Throws
If since_date is not a parseable ISO 8601 date.

Throws
If folder resolves outside the vault.
Example
```
const drafts = await listNotes(vault, {
  tag: "draft",
  folder: "Posts",
  since_date: "2026-01-01",
  limit: 20
});
```
- Defined in tools/read.ts:55