Documentation · Report Bug · Discussions
Everytime we ask ChatGPT, we need to put so much context information for each query. Why spend time putting background infos that are already in your vault?
Smart Composer is an Obsidian plugin that helps you write efficiently with AI by easily referencing your vault content. Inspired by Cursor AI and ChatGPT Canvas, this plugin unifies your note-taking and content creation process within Obsidian.
Upgrade your note-taking experience with our Contextual AI Assistant, inspired by Cursor AI. Unlike typical AI plugins, our assistant allows you to precisely select the context for your conversation.
- Type
@<fname>
to choose specific files/folders as your conversation context - Get responses based on selected vault content
Now, you can add website links and images as additional context for your queries.
- Website content is automatically extracted
- Image support: Add images directly to your chat through:
- Upload button
- Drag & drop
- Paste from clipboard
- Youtube link support: YouTube transcripts are fetched and included as context
- Coming soon: Support for external files (PDF, DOCX, ...)
Smart Composer suggests edits to your document. You can apply with a single click.
- Offers document change recommendations
- Apply suggested changes instantly
Note: The Apply Edit feature is currently slower than desired. We are working on improvements in future updates.
Automatically find and use relevant notes from your vault to enhance AI responses.
- Hit
Cmd+Shift+Enter
to run Vault Search answer - Semantic search across your vault to find the most relevant context
- Custom Model Selection: Use your own model by setting your API Key (stored locally).
- Local Model Support: Run open-source LLMs and embedding models locally with Ollama for complete privacy and offline usage.
- Custom System Prompts: Define your own system prompts that will be applied to every chat conversation.
- Prompt Templates: Create and reuse templates for common queries by typing
/
in the chat view. Perfect for standardizing repetitive tasks.- Create templates from any selected text with one click
⚠️ Important: Installer Version Requirement
Smart Composer requires a recent version of the Obsidian installer. If you experience issues with the plugin not loading properly:
First, try updating Obsidian normally at
Settings > General > Check for updates
.If issues persist, manually update your Obsidian installer:
- Download the latest installer from Obsidian's download page
- Close Obsidian completely
- Run the new installer
- Open Obsidian Settings
- Navigate to "Community plugins" and click "Browse"
- Search for "Smart Composer" and click Install
- Enable the plugin in Community plugins
- Set up your API key in plugin settings
- OpenAI : ChatGPT API Keys
- Anthropic : Claude API Keys
- Gemini : Gemini API Keys
- Groq : Groq API Keys
💡 Free Option Available: While rate-limited, Gemini API provides the best performance among free models for Smart Composer. Recommended for users looking for a free option.
📚 For detailed setup instructions and documentation, please visit our Documentation.
To see our up-to-date project roadmap and progress, please check out our GitHub Projects kanban board.
Some of our planned features include:
- Support for external files (PDF, DOCX, etc.)
- Mentioning with tags or other metadata
We value your input and want to ensure you can easily share your thoughts and report any issues:
-
Bug Reports: If you encounter any bugs or unexpected behavior, please submit an issue on our GitHub Issues page. Be sure to include as much detail as possible to help us reproduce and address the problem.
-
Feature Requests: For new feature ideas or enhancements, please use our GitHub Discussions - Ideas & Feature Requests page. Create a new discussion to share your suggestions. This allows for community engagement and helps us prioritize future developments.
-
Show and Tell: We love seeing how you use Smart Composer! Share your unique use cases, workflows, or interesting applications of the plugin in the GitHub Discussions - Smart Composer Showcase page.
Your feedback and experiences are crucial in making Smart Composer better for everyone!
We welcome all kinds of contributions to Smart Composer, including bug reports, bug fixes, documentation improvements, and feature enhancements.
For major feature ideas, please create an issue first to discuss feasibility and implementation approach.
If you're interested in contributing, please refer to our CONTRIBUTING.md file for detailed information on:
- Setting up the development environment
- Our development workflow
- Working with the database schema
- The process for submitting pull requests
- Known issues and solutions for developers
This project is licensed under the MIT License.
If you find Smart Composer valuable, consider supporting its development:
Follow me on X (Twitter) @andy_suh_ for updates and announcements!
Your support helps maintain and improve this plugin. Every contribution is appreciated and makes a difference. Thank you for your support!