novera-save

name	novera-save
description	Save a link, article, or post INTO Novera — the user's personal "save it for later" library (a bookmarking service). Use when the user wants to bookmark/stash/capture a URL to Novera. NOT for saving to a local file, to disk, or to any other app — only for adding content to the Novera library.
allowed-tools	["Bash(npx novera whoami)","Bash(npx novera items create:*)"]

Save to Novera

Add a URL to the user's Novera library. Novera then fetches the page metadata (title, description, cover) on its own.

When this applies

• "Save this to Novera", "bookmark this in Novera", "stash this link", "add this to my reading list" (when that list is Novera).
• Not this skill: "save this as a file", "write this to disk", "export" — those are local file operations, unrelated to Novera.

Prerequisite — auth

npx novera whoami --json

If this fails with Not authenticated…, tell the user to set NOVERA_API_KEY (a Personal Access Token, opk_…, from the webapp → Settings → Developer → API keys). Never ask them to paste the token into the chat.

Save

npx novera items create "<url>" --json
npx novera items create "<url>" --title "<title>" --json

The response is { item, duplicate }:

• duplicate: false → newly saved.
• duplicate: true → already in the library; the existing item is returned. Tell the user it was already saved rather than implying a new copy.

Only the URL is required; Novera derives the title unless --title is given. See references/capture.md for metadata/anti-bot-source notes.