cdx <command> [args]. Run cdx --help or cdx <command> --help for the
authoritative, always-current text. Global flags (--json, -v/-vv/-vvv,
--catalog <name>, --data-dir <path>) work on every subcommand.
Command Description
cdx catalog init <name> <path>Create + register a catalog (--description, --no-switch) cdx catalog add <name> <path>Register an existing catalog (--description, --no-switch) cdx catalog lsList catalogs cdx catalog use <name>Switch the current catalog cdx catalog rm <name>Unregister (--purge deletes files)
Command Description
cdx add <file>...Import books (--force) cdx lsList books (--columns, --all-columns) cdx inspect <id|title>Show detailed metadata cdx search <query>Search (--author, --tag, --series, --rating) cdx edit <id>Edit metadata in $EDITOR cdx tag <id> <tag>...Add tags cdx untag <id> <tag>...Remove tags (--all) cdx rate <id> <0-5>Set/clear rating cdx series <id> <name>Set series (--index, --clear) cdx rm <id|title>Remove book (--keep) cdx groups --by <field>Group by author/tag/rating/publisher/language/series/format cdx dedupFind duplicates (--by, --rm, --yes, --keep)
Command Description
cdx embed syncEmbed metadata into all pending books
Command Description
cdx device lsList devices cdx device alias <target> <alias>Set/rename alias cdx device booksList device books (--device) cdx device cleanRemove books from a device (--device, --all, --yes) cdx push <id|title>Copy to device (--device) cdx pull <path>Import from device (--device, --force) cdx syncBidirectional sync (--device, --dry-run, --yes, --verify)
Command Description
cdx tuiOpen the terminal UI cdx updateSelf-update (--check, --yes) — see Updating cdx cdx completions <shell>Print a completion script — see Shell completions
Every read command accepts --json and emits JSONL — one JSON object per
line, no surrounding array — so it streams through jq -c, head, and
fzf --preview. A command with zero records prints nothing.
cdx ls --json | jq -c 'select(.rating >= 4) | {title, rating}'
cdx search --author tolkien --json | jq -r '.title'