Skip to main content
Version: Next 🚧

QuickAdd CLI

QuickAdd now registers native Obsidian CLI handlers when your Obsidian version supports plugin CLI commands.

Requirements​

  • Obsidian 1.12.2 or newer (plugin CLI handler API introduced in 1.12.2)
  • QuickAdd enabled in the target vault

Commands​

quickadd / quickadd:run​

Run a QuickAdd choice from the CLI.

obsidian vault=dev quickadd choice="Daily log"
obsidian vault=dev quickadd:run id="choice-id"

quickadd:list​

List all QuickAdd choices (including nested choices inside multis).

obsidian vault=dev quickadd:list
obsidian vault=dev quickadd:list type=Capture
obsidian vault=dev quickadd:list commands

quickadd:check​

Check which inputs are still missing before a non-interactive run.

obsidian vault=dev quickadd:check choice="Daily log"

Passing variables​

QuickAdd CLI supports three variable patterns:

  1. value-<name>=... (URI-compatible)
  2. extra key=value args
  3. vars=<json-object> for structured values

Examples:

obsidian vault=dev quickadd \
  choice="Daily log" \
  value-project="QuickAdd" \
  mood="focused"

obsidian vault=dev quickadd \
  choice="Daily log" \
  vars='{"project":"QuickAdd","sprint":42}'

Non-interactive behavior​

By default, quickadd and quickadd:run are non-interactive. If QuickAdd detects missing inputs, it returns a JSON payload with missing fields and missingFlags suggestions instead of opening prompts.

Use ui to allow interactive prompts:

obsidian vault=dev quickadd choice="Daily log" ui