Use jotcli --help to see all commands. Use --help after a command to see its options.
The operation reference maps Jot tasks to jotcli commands, REST routes, and MCP identifiers.
Authentication
jotcli auth login saves a Jot key on your device. jotcli auth status checks that key. jotcli auth logout removes it.
You can set JOT_BASE_URL and JOT_API_KEY for one shell session instead of saving a key.
Read Install jotcli for setup steps.
Note files
jotcli note publish FILE reads Markdown with optional YAML frontmatter. A CLI flag takes priority over the matching frontmatter field.
The command reads title, slug, collection, tags, password, expires, listed, draft, and created from frontmatter.
Use --draft to save a draft, or --unlisted to keep a published note out of listings.
Reusing a slug updates the existing note. The command uploads local images linked from the Markdown file.
jotcli note get ID --markdown writes Markdown with frontmatter. Use --json for structured output.
Select notes
Filter note list with repeatable --select values: tag=NAME, collection=NAME, collection=none, status=draft, status=published, or slug~PREFIX.
Use --limit N to show fewer rows.
For bulk changes, use note bulk --select ... or note bulk --all. Move notes with --move-to. Change tags with --add-tag or --remove-tag.
Change listing with --listed or --unlisted. Change state with --published or --unpublished. Move notes to Trash with --delete.
Use --dry-run to inspect the selection first. --delete cannot be combined with other bulk actions.
WordPress import
Use jotcli import wp --source URL --dry-run to inspect public posts and pages. Remove --dry-run to import them.
Use --type posts or --type pages to limit the content type. Use --tag NAME or --collection NAME to filter or group notes.
The CLI lists --include-drafts, --wp-user, and --wp-pass, but the current import route does not use those values.
Do not rely on them to import private or draft WordPress content.
Site controls
Use site themes to list themes. Use the reader and domain commands in the operation reference to manage private-site access and custom domains.
The remove commands ask for confirmation unless you pass --yes.
Export and updates
jotcli export --output FILE checks the ZIP before it saves the output file. It does not overwrite an existing file.
Use jotcli update --check to check for a new CLI version. Use jotcli update to install it.
The updater uses your configured Jot server to get the version and binary. It does not need GitHub access or a Jot API key. It can update an installed binary. For a source installation, use your source installation procedure.
Older binaries request release information from GitHub. If that request returns HTTP 404, use the installer to update manually. The corrected updater is available from version 0.9.4.