release(version): Release 2.12.0 [skip ci]

# [2.12.0](2.11.0...2.12.0) (2026-03-05)

### Bug Fixes

* **capture:** preserve canvas tab indentation on configured writes ([#1125](#1125)) ([0a1578e](0a1578e))
* disallow capture targets with .base extension ([cb39ed4](cb39ed4))
* **field-suggestions:** opt-in inline values from fenced code blocks ([#1128](#1128)) ([8597905](8597905))
* **gui:** preserve modal edit position during settings reload ([#1132](#1132)) ([11bda19](11bda19))
* **gui:** reduce ai settings modal reload churn ([#1134](#1134)) ([ae0f7a1](ae0f7a1))
* **gui:** reduce choice builder reload churn ([#1136](#1136)) ([818272a](818272a))
* **gui:** reduce macro settings modal reload churn ([#1135](#1135)) ([a1a6271](a1a6271))
* harden existing-tab matching and document issue workflow ([#1108](#1108)) ([7b12d3b](7b12d3b))
* make template path resolution deterministic ([3297d54](3297d54))
* normalize capture title for non-markdown targets ([964d672](964d672))
* preserve capture-format spacing for insert-at-end ([#1119](#1119)) ([8bb8ed4](8bb8ed4))
* preserve explicit capture target file extensions ([57e43ff](57e43ff))
* preserve insert-at-end order for non-newline captures ([#1120](#1120)) ([e7cbbf2](e7cbbf2))
* resolve template file-name paths without duplicate default folder ([7bfd41b](7bfd41b))
* resolve vault-relative template paths using root folders ([81216de](81216de))

### Features

* add AI request logging API and reduce assistant log noise ([#1110](#1110)) ([2c36800](2c36800))
* automate docs version snapshot during release ([#1111](#1111)) ([1571846](1571846))
* **capture:** fully support capture into canvas cards ([#1124](#1124)) ([a53f889](a53f889))
* **cli:** add native QuickAdd Obsidian CLI handlers ([#1129](#1129)) ([8102d47](8102d47))
* **format:** support mapped VALUE suggester display text ([#1127](#1127)) ([b8ec56c](b8ec56c))
* **macro:** add editor cursor navigation commands ([101d5f6](101d5f6))
* support .base template files for template choices ([11e6490](11e6490))

### Reverts

* **gui:** remove modal reload refactor series ([#1137](#1137)) ([3ba1a73](3ba1a73)), closes [#1136](#1136) [#1135](#1135) [#1134](#1134) [#1133](#1133) [#1132](#1132)

Author: semantic-release-bot

docs/versioned_docs/version-2.12.0/AIAssistant.md

@@ -0,0 +1,159 @@
+---
+title: AI Assistant
+---
+
+# AI Assistant
+
+The AI Assistant in QuickAdd leverages the power of Large Language Models (LLMs) to act as your personal AI assistant within Obsidian. It can streamline your workflows by automating routine tasks and providing intellectual support. To use this feature, you need the QuickAdd plugin and a provider you'd like to use.
+
+## How to Setup the AI Assistant
+
+To set up the AI Assistant, follow these steps:
+
+1. In Obsidian, create a new folder dedicated to AI prompt templates, e.g. `bins/ai_prompts`.
+2. Navigate to QuickAdd settings and locate the "AI Assistant" section. Specify the path to the folder you created in step 1.
+3. In the same section, add a provider to get started. If you are using OpenAI, you will need to add your API key to the settings. As of v1.8.x, you need to enter your API key in the [provider](#providers) settings. The video below is from an older version, but the process is the similar.
+
+![AI Assistant Setup](./Images/AI_Assistant_Setup.gif)
+
+That's really it. You're now ready to use the AI Assistant.
+
+The basic idea is that you set up a QuickAdd Macro, which will trigger the AI Assistant.
+The AI Assistant will then use the prompt template you specify to generate a prompt, which it will then send to your selected provider.
+The provider will then return a response, which the AI Assistant passes on to the QuickAdd Macro.
+You can then use the response in subsequent steps in the macro, e.g. to capture to a note, or create a new note.
+
+**Creating prompt templates is simple: just create a note in your prompt templates folder.**
+
+Creating prompt templates is as simple as creating a note within your prompt templates folder. These templates can utilize QuickAdd's [Format Syntax](./FormatSyntax.md) or [Inline Scripts](./InlineScripts.md).
+
+Here's an example of how you can set up a prompt template:
+
+![AI Assistant Macro](./Images/AI_Assistant_Macro.gif)
+
+You can also use AI Assistant features from within the [API](./QuickAddAPI.md).
+
+## Providers
+
+QuickAdd supports multiple providers for LLMs.
+QuickAdd works with OpenAI-compatible APIs and also supports Google Gemini.
+
+Here are a few providers that are known to work with QuickAdd:
+
+-   [OpenAI](https://openai.com)
+-   [Gemini (Google AI)](https://ai.google.dev)
+-   [TogetherAI](https://www.together.ai)
+-   [Groq](https://groq.com)
+-   [Ollama (local)](https://ollama.com)
+
+Paid providers expose their own API, which you can use with QuickAdd. Free providers, such as Ollama, are also supported.
+
+By default, QuickAdd will add the OpenAI and Gemini providers. You can add more providers by clicking the "Add Provider" button in the AI Assistant settings. This now opens a preset picker with common providers (OpenAI, Gemini, Groq, Together, OpenRouter, etc.). Select or create a SecretStorage entry for your API key and click Connect to add the provider. You can also add a custom provider.
+
+QuickAdd stores provider API keys in Obsidian's SecretStorage. The provider settings only keep the secret name, not the key itself.
+Existing provider API keys are migrated into SecretStorage automatically.
+
+Here's a video showcasing adding Groq as a provider:
+
+<video controls style={{width: "100%"}}>
+
+  <source src="https://github.com/chhoumann/quickadd/assets/29108628/493b556a-a8cd-4445-aa39-054d379c7bb9" type="video/mp4"/>
+</video>
+
+### Local LLMs
+
+You can use your own machine to run LLMs. This is useful if you want to keep your data private, or if you want to use a specific model that isn't available on the cloud.
+To use a local LLM, you need to set up a server that can run the model.
+You can then add the server as a provider in QuickAdd.
+
+One such server is [Ollama](https://ollama.com). Ollama is a free, open-source, and self-hosted LLM server. You can set up Ollama on your own machine, and then use it as a provider in QuickAdd.
+You can find the [quick start documentation here](https://github.com/ollama/ollama/blob/main/README.md#quickstart).
+Ollama binds to the port `11434` ([src](https://github.com/ollama/ollama/blob/main/docs/faq.md#how-can-i-expose-ollama-on-my-network)), so your provider settings would be as follows:
+
+```
+Name: Ollama
+URL: http://localhost:11434/v1
+API Key secret: (empty)
+```
+
+And that's it! You can now use Ollama as a provider in QuickAdd.
+Make sure you add the model you want to use. [mistral](https://ollama.com/library/mistral) is great.
+
+### Gemini (Google AI)
+
+Gemini is supported out of the box.
+
+```
+Name: Gemini
+URL: https://generativelanguage.googleapis.com
+API Key secret: (AI Studio API key)
+Models (add one or more):
+  - gemini-1.5-pro (Max Tokens: 1000000)
+  - gemini-1.5-flash (Max Tokens: 1000000)
+  - gemini-1.5-flash-8b (Max Tokens: 1000000)
+```
+
+Notes:
+
+- Use only supported parameters for Gemini (temperature, top_p). Frequency/presence penalties are not sent to Gemini.
+- Make sure "Disable AI & Online features" is turned off in QuickAdd settings to enable requests.
+
+### Importing and syncing models
+
+- Use the **Model source** dropdown inside each provider to choose where QuickAdd discovers models: your provider's `/v1/models` endpoint, the public models.dev directory, or an automatic mode that tries the provider first and falls back to models.dev.
+- The "Browse models" button pulls from whichever source you selected, letting you search and multi-select models even for custom OpenAI-compatible endpoints that models.dev does not list.
+- Choose Add-only to merge or Replace to overwrite the provider's model list.
+- Enable Auto-sync to keep your model list updated; use Sync now for a manual refresh. Auto-sync honors the same model source you picked.
+
+## AI Assistant Settings
+
+Within the main AI Assistant settings accessible via QuickAdd settings, you can configure the following options:
+
+-   Providers: Configure provider endpoints and API key secrets (SecretStorage).
+-   Prompt Templates Folder: The location where all your prompt templates reside.
+-   Default model: The default OpenAI model to be used.
+-   Show Assistant: Toggle for status messages.
+-   Default System Prompt Template: Sets the behavior of the model.
+
+For each individual AI Assistant command in your macros, you can set these options:
+
+-   Prompt Template: Determines the prompt template to use.
+-   Model: Specifies the OpenAI model to use, overriding the default model.
+-   Output Name Variable: Sets the variable name for the AI Assistant’s output.
+-   System Prompt Template: Determines the models behavior, overriding the default system prompt template.
+
+You can also tweak model parameters in advanced settings:
+
+-   **temperature:** Allows you to adjust the sampling temperature between 0 and 2. Higher values result in more random outputs, while lower values make the output more focused and deterministic.
+-   **top_p:** This parameter relates to nucleus sampling. The model considers only the tokens comprising the top 'p' probability mass. For example, 0.1 means only tokens from the top 10% probability mass are considered.
+-   **frequency_penalty:** A parameter ranging between -2.0 and 2.0. Positive values penalize new tokens based on their frequency in the existing text, reducing the model's tendency to repeat the same lines. (Not applicable to Gemini.)
+-   **presence_penalty:** Also ranging between -2.0 and 2.0, positive values penalize new tokens based on their presence in the existing text, encouraging the model to introduce new topics. (Not applicable to Gemini.)
+
+## AI-Powered Workflows
+
+You can create powerful workflows utilizing the AI Assistant. Some examples are:
+
+-   **Generating Writing Prompts:** Using links to related notes to generate writing prompts.
+-   **Summarizer:** Create summaries of selected text.
+-   **Transform Selected:** Transform selected text based on provided instructions.
+-   **Flashcard Creator:** Generate flashcards based on selected text.
+-   **Get Me Started Writing About…:** Generate points to kickstart your writing on a given topic.
+-   **Manual Prompt:** Provide a manual prompt to the AI assistant.
+-   **Alternative Viewpoints:** Obtain alternative perspectives and improvements on your draft.
+-   **Prompt Chaining:** Chain multiple prompts together, with each prompt using the output of the previous one.
+
+All of these examples, and more, can be found in [Christian's blog post about the AI Assistant](https://bagerbach.com/blog/obsidian-ai).
+
+Please note, using the AI Assistant will incur costs depending on the API usage. Set spending limits on your OpenAI account to avoid unexpected expenses. Play around with different models to find the one that best suits your needs.
+
+### Example: Summarizer
+
+Here’s a simple prompt where you select some text, and then use the assistant with that prompt.
+Then it’ll spit out an AI-generated summary:
+
+```markdown
+Please summarize the following text. Use only the text itself as material for summarization, and do not add anything new. Rewrite this for brevity, in outline form:
+{{value}}
+```
+
+You can use the getting-started demonstration shown earlier to set this up.

docs/versioned_docs/version-2.12.0/Advanced/CLI.md

@@ -0,0 +1,74 @@
+---
+title: 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.
+
+```bash
+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).
+
+```bash
+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.
+
+```bash
+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:
+
+```bash
+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:
+
+```bash
+obsidian vault=dev quickadd choice="Daily log" ui
+```
+

docs/versioned_docs/version-2.12.0/Advanced/ObsidianUri.md

@@ -0,0 +1,57 @@
+---
+title: Open QuickAdd from a URI
+---
+
+QuickAdd choices can be launched from external scripts or apps such as Shortcuts on Mac and iOS, through the use of the `obsidian://quickadd` URI.
+
+If you prefer shell scripting, see [QuickAdd CLI](./CLI.md) for native Obsidian
+CLI handlers.
+
+```
+obsidian://quickadd?choice=<YOUR_CHOICE_NAME>[&value-VALUE_NAME=...]
+```
+
+:::note
+
+All parameter names and values must be properly [URL encoded](https://en.wikipedia.org/wiki/Percent-encoding) to work. You can use an online tool like [urlencoder.org](https://www.urlencoder.org/) to help you easily encode parts of the URI.
+
+:::
+
+The only required parameter is `choice` which selects the choice to run by its name. The name must match exactly, otherwise it will not be able to be found.
+
+[Variables to your choice](../FormatSyntax.md) are passed as additional `value-VARIABLE_NAME` parameters, with `value-` prefixing the name. Variables with a space in their name can still be used, but the spaces in the name must be encoded as `%20` as usual. For example, a capture asking for a variable named `log notes` would be passed as `value-log%20notes=...` in the URI.
+
+Keep in mind that unnamed variables (a bare `{{VALUE}}`/`{{NAME}}` or `{{MVALUE}}`) cannot be filled by the URI and you will instead be prompted inside Obsidian as usual.
+
+## Vault parameter
+
+Like every Obsidian URI, you can use the special `vault` parameter to specify which vault to run QuickAdd in. If left blank, it will be executed in your most recent vault.
+
+```
+obsidian://quickadd?vault=My%20Vault&choice=Daily%20log&value-contents=Lorem%20ipsum.
+```
+
+## Important: Sync Service Limitations
+
+:::warning
+
+When using QuickAdd via URI with sync services (Obsidian Sync, iCloud, Dropbox, etc.), be aware of a critical limitation:
+
+**If Obsidian hasn't been opened on a device**, files created on other devices won't be synced yet. This can cause QuickAdd to create duplicate files that overwrite the synced versions when they arrive.
+
+### Example Scenario
+1. You create a Daily Note on your laptop
+2. Without opening Obsidian on your phone, you trigger a Capture via URI
+3. QuickAdd checks if the Daily Note exists (it doesn't locally)
+4. QuickAdd creates a new Daily Note
+5. When sync runs, the new file overwrites the one from your laptop
+
+### Workarounds
+- **Open Obsidian first**: Always open Obsidian and wait for sync before using URIs
+- **Use device-specific names**: Configure different filename formats per device (e.g., `{{date}}-mobile`)
+- **Capture to active file**: Use an already-open note to avoid file creation issues
+- **Include timestamps**: Add `{{time}}` to filenames to ensure uniqueness
+
+This is a fundamental limitation of file-based sync services and cannot be fully resolved without sync status APIs.
+
+:::