Qjzd Nav Cli Operations

Use when managing QJZD Nav backups, restore, and site settings including uploading background images, logos, and favicons.

Security Scan

The skill is an instruction-only wrapper for a local 'qjzd-nav' CLI (backup and settings operations); its requirements and instructions align with that purpose and do not request unrelated credentials or installs.

Purpose & Capability

Name and description match the runtime instructions and the declared required binary (qjzd-nav). The commands shown (backup, settings, upload) are exactly what the description says the skill does. References to an auth helper are reasonable for a CLI that needs credentials.

Instruction Scope

SKILL.md only instructs the agent to run qjzd-nav subcommands and to upload local files; it does not request unrelated files, environment variables, or external endpoints. However, many commands are state-changing (delete, import, upload) and will affect the remote server and may transmit local files — users should be aware the agent will perform destructive or privacy-sensitive operations if invoked.

Install Mechanism

No install spec and no code files — instruction-only. This minimizes disk-write risk because nothing is downloaded or installed by the skill itself.

Credentials

The skill requests no environment variables or credentials. It does assume an existing, authenticated qjzd-nav CLI; any required auth is external (e.g., qjzd-nav-cli-auth), which is proportionate to the described function.

Persistence & Privilege

always is false (no forced inclusion); the skill can be invoked autonomously by the agent by default (platform normal), but it does not request persistent installation or modify other skills' configuration.

Assessment

This skill is coherent and appears to simply document how to use your local qjzd-nav CLI. Before installing/using it: (1) confirm the qjzd-nav binary is the legitimate tool you expect (check vendor, version, and path); (2) ensure authentication for qjzd-nav is configured separately and securely (the skill references an auth helper); (3) be cautious about allowing autonomous runs because commands can delete backups, import data (which can overwrite), and upload local files — test commands manually first in a safe environment; (4) avoid uploading sensitive local files unless you trust the remote server; (5) if you have concerns about autonomous agent actions, limit or review agent permissions before enabling automatic invocation.

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

Field	Type	Description
--site-title	string	Site title
--site-subtitle	string	Site subtitle
--logo-icon	string	Lucide icon class (e.g., i-lucide-compass)
--logo-image	string	Logo image URL
--favicon	string	Favicon URL
--background-image	string	Background image URL
--background-overlay	number	Background overlay 0-100 (default: 20 when uploading)
--show-shortcut-hints	boolean	Show keyboard shortcut hints
--sidebar-collapsed	boolean	Sidebar default collapsed state
--show-edit-button	boolean	Show edit button
--show-settings-button	boolean	Show settings button

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.