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

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

Connect Smart Composer to external MCP servers. MCP lets you use powerful third-party tools and data sources right inside your chat.

• Custom Model Selection: Use your own model by setting your API Key (stored locally). Supported providers:
  • OpenAI
  • Anthropic
  • Google (Gemini)
  • Groq
  • DeepSeek
  • OpenRouter
  • Azure OpenAI
  • Ollama
  • LM Studio
  • MorphLLM
  • Any other OpenAI-compatible providers
• 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

1. Open Obsidian Settings
2. Navigate to "Community plugins" and click "Browse"
3. Search for "Smart Composer" and click Install
4. Enable the plugin in Community plugins
5. Set up your API key in plugin settings
   • OpenAI : ChatGPT API Keys
   • Anthropic : Claude API Keys
   • Gemini : Gemini API Keys
   • Groq : Groq API Keys

📚 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

These contributors were instrumental in shaping the initial vision, architecture, and design of Smart Composer:

@glowingjade (Twitter), @kevin-on, @realsnoopso (Twitter · LinkedIn), @woosukji

We also want to thank everyone else who has contributed. Your time and effort help make Smart Composer better for everyone!

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!