Command line

vesper reads and writes your entries from a terminal, and lets agents such as Claude Code do the same through a skill. It needs Node.js 22.12 or newer.

npm install -g @pleasure1234/vesper
vesper login

vesper login opens your browser: sign in, unlock the workspace with your passkey and allow the access. The CLI keeps the sign-in in ~/.config/vesper/auth.json, readable only by you, and renews it on its own. vesper logout revokes it. On Free the sign-in is read-only; writing needs Pro. Set VESPER_TOKEN to a personal token instead for scripts and CI.

Commands

Command	Does
vesper whoami	Workspace, plan, role and whether this sign-in can write
vesper entries list	Entries newest first; --tag, --from, --to, --in, --pinned
vesper entries search <words>	Entries whose text or tags contain the words; the same filters
vesper entries get <id>	One entry with its full Markdown
vesper entries create <text>	A new entry; --file, --stdin, --tag, --public (Pro)
vesper entries update <id>	Change text, tags, visibility, pin, favorite or archive (Pro)
vesper entries delete <id> --yes	Delete for good (Pro)
vesper tags list	Tags and their counts
vesper tags rename <from> <to>	Rename a tag everywhere (Pro); tags remove <tag> removes it
vesper photos list	Photos with their entry, time and place
vesper photos download <id>	Save the original, or --thumb
vesper skill	Install the agent skill into ~/.claude/skills/vesper

Output is JSON. Lists come a page at a time with a next; pass it back with --cursor, or use --all to follow every page (up to --max, 500 by default). Dates are YYYY-MM-DD in UTC. Run vesper <command> --help for every flag.