saveit-cli

CLI for the SaveIt.now API - manage bookmarks. Made with api2cli.dev.

Install

npx api2cli install Melvynx/saveit-cli

This clones the repo, builds the CLI, links it to your PATH, and installs the AgentSkill to your coding agents.

Install AgentSkill only

npx skills add Melvynx/saveit-cli

Auth

# Save your API token
saveit-cli auth set sk-abc123xyz

# Verify your token works
saveit-cli auth test

# Display current token (masked)
saveit-cli auth show

# Display full unmasked token
saveit-cli auth show --raw

# Delete saved token
saveit-cli auth remove

Bookmarks

List bookmarks

saveit-cli bookmarks list
saveit-cli bookmarks list --query "web development" --json
saveit-cli bookmarks list --tags design,ux --limit 5
saveit-cli bookmarks list --types ARTICLE,VIDEO
saveit-cli bookmarks list --special UNREAD --limit 10

Flag	Description
--query <query>	Search query
--tags <tags>	Filter by tags (comma-separated)
--types <types>	Filter by types: ARTICLE, VIDEO, IMAGE, AUDIO, PDF, DOCUMENT, OTHER
--special <special>	Filter by special: READ, UNREAD, STAR
--limit <n>	Max results (default: 20)
--cursor <cursor>	Pagination cursor
--fields <cols>	Comma-separated columns to display

Create a bookmark

saveit-cli bookmarks create --url "https://example.com"
saveit-cli bookmarks create --url "https://example.com" --title "Example" --tags dev,web
saveit-cli bookmarks create --url "https://example.com" --type ARTICLE --json

Flag	Description
--url <url>	URL to bookmark (required)
--title <title>	Bookmark title
--description <description>	Bookmark description
--tags <tags>	Comma-separated tags
--type <type>	Bookmark type: ARTICLE, VIDEO, IMAGE, AUDIO, PDF, DOCUMENT, OTHER

Delete a bookmark

saveit-cli bookmarks delete bm_123456
saveit-cli bookmarks delete bm_123456 --json

Global Flags

All commands support:

Flag	Description
--json	Output as JSON
--format <fmt>	Output format: text, json, csv, yaml
--verbose	Enable debug logging
--no-color	Disable colored output
--no-header	Omit table/csv headers (for piping)