Skip to content

Official Smart Plugins site Smart Plugins are independent third-party plugins for Obsidian. Smart Connections is the flagship plugin.

Ask questions using your notes with Smart Chat API Extension

Choose a local or cloud model, attach notes from your vault, and ask a question inside Obsidian.

Context is request-specific

Smart Chat does not automatically send your whole vault. Prior conversation messages can carry forward, but attached source context does not automatically copy to the next response. Review or select the sources for each request.

For a provider website inside a note, use Smart Chat Getting Started; no API model is required. To keep provider or API thread references in a smart-chat codeblock, see the universal codeblock guide.

Before you start

You need:

The model must pass its available Test action or complete a small request. If testing returns an authorization error such as 401, repair the credential before attaching sensitive sources.

Ask a question using a note

1. Confirm one working model

  1. Open Browse Smart Plugins.
  2. Make sure that Chat Pro is enabled.
  3. Open the Chat model controls in one of these locations:
    • On the Chat Pro row, select Open settings.
    • In Smart Environment settings, open the Chat model controls.
  4. Under Chat models, select + New.
  5. Select an enabled provider, such as PRO: Open Router (cloud), PRO: OpenAI (cloud), or PRO: Ollama (local, requires Ollama app).
  6. Enter the required provider fields.
    • For a cloud provider, enter its API Key.
    • For Ollama, enter the Ollama host.
    • If you use Ollama, make sure that the Ollama app is running.
  7. If the provider must load its model list, select Refresh Models.
  8. Select Chat Model.
  9. Save or close the editor.
  10. If several models exist, select Default chat model.
  11. Make sure that the intended row is Current.
  12. Run Test on the row or Test model in the editor.

Stop if the interface shows MISSING MODEL, MISSING PROVIDER, or a failed test. Current means that the model is selected. Run the model test to check credentials, provider access, or the local server.

See Confirm or change the chat model.

2. Open or start a thread

Open Smart Chat in one of these ways:

Smart Chat resumes the active saved thread when possible. Otherwise it opens the newest non-deleted thread or creates a new one. Use New Chat to start a separate conversation for your question.

The toolbar also contains Chat History, Chat Settings, and Chat Help.

3. Write your question

Choose a note you want to summarize. In the composer, enter:

Summarize the attached note's main points in three bullets.

Attach that note in the next step.

4. Attach your note

Select Add context and choose the note you want to summarize. You can also type @ in the composer to choose it.

For other questions, use Lookup context to find a source or select a saved named context containing the notes you need.

On the first response, enter at least three words or more than ten characters before expecting Lookup context to enable. After a completed response, Lookup can be available for a continuation.

For source controls and drag paths, use known-note context, Lookup context, and drag and drop.

5. Check the attached note

Once the note is attached, Add context becomes Open context builder. Open Builder to check the note's name and path, and remove any sources you did not intend to include.

6. Send your question

Check the selected model and attached note, then select Send or use the default Shift + Enter shortcut.

If no context is attached, the dialog offers Lookup context, Select context, Continue without context, or Cancel. Choose Select context to attach your note. For a question that needs no notes, choose Continue without context.

After sending, expect the thread status to move through Typing or Generating... before the completed response appears. An Error state is a failed generation, not a response.

7. Read the summary

Compare the three bullets with your note's main points. Ask a follow-up question for any details you need.

The completed response can show its model, attached context, user message, and assistant answer.

Reopen and manage saved threads

To reopen or manage saved threads:

Press Enter to open the selected saved thread.

Use the row actions to open, rename, or delete the intended thread. Deletion requires confirmation.

Recover without changing everything at once

Problem First recovery Detailed guidance
MISSING MODEL Under Chat models, select + New. Complete the provider and Chat Model fields. Select the model under Default chat model. Make sure that the row is Current. Run Test or Test model. Model setup
MISSING PROVIDER Repair the provider, credential, or local server configuration. Run the model test again. Model recovery
Test returns 401 or another authorization error Replace or repair the provider credential. Do not send note content until the test succeeds. Model recovery
Error after sending Keep the same prompt. Correct the reported model or provider problem. Retry once. Model recovery
Weak Lookup candidates Make the question more specific. Check Environment coverage. Check the exclusions. Improve retrieval
Generic or unsupported answer Clarify the question, add missing notes, or remove unrelated sources. Attach the revised source set and send a new request. Review context
Contradiction with a source Open the source and compare the conflicting passages. Revise the answer where needed. Review responses
Expected prior sources are absent Open Add context or Open context builder. Select the sources again. Attached context does not automatically copy to the next response. Review context

Data handling and next steps

A cloud provider receives the question and source content selected for its request. A local provider can remain on the machine when that local runtime is active. Confirm the selected provider's data-handling terms before sending sensitive notes.

Next need Continue with
Full Chat controls, persistence, context, and recovery Smart Chat API Extension documentation
Saved-thread search, rename, and deletion Thread management documentation
Reusable reviewed source sets Smart Context Builder
Better semantic retrieval Smart Lookup
Provider-thread links stored in notes Smart Chat Core Getting Started
A repeatable delegation and review loop Smart Loop
A specific vault change Connect Pro