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.
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:
- Smart Chat Pro installed and enabled
- one compatible chat model
- valid provider credentials or a running local model server
- the note you want to summarize
- Smart Environment retrieval readiness only when using Lookup context
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
- Open Browse Smart Plugins.
- Make sure that Chat Pro is enabled.
- 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.
- Under Chat models, select + New.
- Select an enabled provider, such as PRO: Open Router (cloud), PRO: OpenAI (cloud), or PRO: Ollama (local, requires Ollama app).
- 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.
- If the provider must load its model list, select Refresh Models.
- Select Chat Model.
- Save or close the editor.
- If several models exist, select Default chat model.
- Make sure that the intended row is Current.
- 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:
- In the Command Palette under Smart Chat Pro, run Open Smart Chat.
- Select the Smart Chat ribbon action.
- Use an assigned hotkey.
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:
- Use Chat History to reopen a recent saved thread. History searches thread names and displayed recent user-prompt previews, not every word in every message.
- Press
Enterto open the selected History item. - Request deletion from History with the shortcut for your platform:
- On macOS, press
Cmd + Enter. - On other platforms, press
Ctrl + Enter.
- On macOS, press
- Before deletion, make sure that the named thread is correct.
- Run Open: Chat Manager view from the Command Palette under Smart Chat Pro. Use Chat Manager for search, rename, deletion, and counts.

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 |