QJZD Nav CLI Operations

Use this skill for qjzd-nav backup and qjzd-nav settings.

If auth may not be ready, check qjzd-nav auth current first or load qjzd-nav-cli-auth.

Commands

qjzd-nav backup --help
qjzd-nav settings --help

Backups

List backups:

qjzd-nav backup list
qjzd-nav backup list --json

Export backup (JSON format):

qjzd-nav backup export
qjzd-nav backup export --output ./backup.json
qjzd-nav backup export --json

Export backup with assets (ZIP format):

qjzd-nav backup export-zip
qjzd-nav backup export-zip --output ./backup.zip

Download a backup file:

qjzd-nav backup download --filename "qjzd-nav-backup-2024-01-01.json" --output ./download.json

Delete a backup:

qjzd-nav backup delete --filename "qjzd-nav-backup-2024-01-01.json"

Import backup (JSON only):

qjzd-nav backup import --file ./backup.json

Settings

Get current settings:

qjzd-nav settings get
qjzd-nav settings get --json

Update settings:

qjzd-nav settings update --site-title "My Nav" --site-subtitle "Links"
qjzd-nav settings update --logo-icon "i-lucide-star"
qjzd-nav settings update --background-overlay 50
qjzd-nav settings update --show-shortcut-hints --show-edit-button

Upload file (background, logo, or favicon):

# Upload and set as background image (default overlay: 20%)
qjzd-nav settings upload --type background --file ./bg.jpg

# Upload and set as logo
qjzd-nav settings upload --type logo --file ./logo.png

# Upload and set as favicon
qjzd-nav settings upload --type favicon --file ./favicon.ico

Supported file types:

• Background: PNG, JPG, WEBP
• Logo: PNG, JPG, SVG, ICO
• Favicon: PNG, SVG, ICO

Settings Fields

Rules

• backup import only supports JSON format, not ZIP.
• When uploading background, --background-overlay defaults to 20%.
• Use --json for automation and scripts.
• Backup files are stored on the server with a maximum of 100 backups.