Repository navigation
v0.16.0
Security
Please update. This release hardens path limits (--allow-path, --deny-path) against symbolic links on a server vault. Details follow in an advisory.
Update your server first. With a path limit, this zn asks the server to mark links, and refuses with a clear message on a server that cannot: any server older than 2.82.1. The reason also shows in vault_info. Access-only limits such as --read-only, and clients with no limits, keep working on any server.
What's new
zn mcp can manage attachments and more (#34, #35). 11 new tools, 45 in all. Thank you, Asterythm.
read_asset: returns an image, text or an embedded file, up to 5 MiB.upload_asset: adds a file from base64, up to 16 MiB, never overwriting, and returns the embed to paste into a note.rename_asset,move_asset: also update the notes that link to the file.duplicate_asset,delete_asset,restore_asset: deleting is soft, with an undo token.list_assets {deleted: true}lists what can be restored.update_task: changes a task's due date, priority,@waiting, state, status or text.daily_note: finds the note under the vault's own settings without changing anything.note_sections,edit_section: list a note's headings, read the part under one, or append, prepend or replace it.
Purging deleted files is left out on purpose: it cannot be undone. With a path limit on a server, renaming, moving, reading and duplicating attachments are refused.
Fixes
- A server switching its own vault no longer redirects
zn mcpsilently (#37). Calls stop untilvault_inforeports the new vault, so nothing lands in the wrong one. - Renaming a file in the TUI updates bare embeds and counts them as uses (#36). On a server older than 2.50.4 the rename still works, but embeds are not rewritten.
- A renamed file that gains a space keeps its plain Markdown links working on a local vault.
How to test locally
T=$(mktemp -d); mkdir -p "$T/vault/inbox/Projects" "$T/vault/inbox/Private" "$T/vault/assets"
printf '# Plan\n\n![[photo.png]]\n' > "$T/vault/inbox/Projects/Plan.md"
printf '# Secret\n' > "$T/vault/inbox/Private/Secret.md"
printf 'x' > "$T/vault/assets/photo.png"
zn tui --vault "$T/vault"- In the Files view, rename
photo.png. Before:Plan.mdkept the old name. After: its embed follows the new name. - Connect an MCP client with
zn mcp --vault "$T/vault"and list tools: 45. - Connect with
zn mcp --vault "$T/vault" --allow-path inbox/Projects:list_notesshows onlyPlan,note_sectionsreads it, andread_noteoninbox/Private/Secret.mdanswers "Note not found".