Quick Start Guide
Start using AI in Obsidian in under 5 minutes
Your first AI chat in 3 steps
1. Install SystemSculpt AI (2 minutes)
Open Settings (the gear icon ⚙️) → Community Plugins → Browse → Search "SystemSculpt" → Install → Enable
2. Click the message square icon
Find it in your left sidebar. Click to open your first chat!
3. Start chatting
Type anything and press Enter. Try:
- "Help me organize my daily notes"
- "What can you do?"
- "Summarize this note" (drag a note into chat first)
That's it! You're now chatting with AI inside Obsidian.
Choose your AI (30 seconds)
SystemSculpt works with any AI provider. Pick what works for you:
Option 1: Use SystemSculpt AI (easiest)
- Get a SystemSculpt AI license key at systemsculpt.com
- Go to Settings → SystemSculpt → Setup → Add your license key
- Click the model indicator button in chat to select a SystemSculpt model
- Start chatting with premium AI models!
Option 2: Use your own API key
Have an OpenAI or Anthropic account?
- Go to Settings → SystemSculpt → Providers
- Click your provider
- Paste your API key
- Save and start chatting
Option 3: Run AI locally (private)
Want AI on your computer? Set up Ollama in 5 minutes.
Power moves to try right now
Make AI understand your notes
- Drag any note into the chat window
- Ask: "What are the key points here?"
- AI reads and summarizes instantly
Turn chaos into structure
- Enable Agent Mode (Pro feature - click the gear in chat)
- Say: "Look at my recent notes and suggest a folder structure"
- AI analyzes your vault and provides organization ideas
Never lose an idea
- Click the microphone 🎤
- Speak your thoughts
- AI writes down what you said and can organize it into notes
Find connections you missed
- Enable Embeddings in settings (Pro feature)
- Use the Similar Notes panel (network icon in sidebar)
- See related notes based on meaning, not just keywords
Essential shortcuts
What you want | How to do it |
---|---|
New chat | Type /new in chat |
Send message | Enter |
New line (without sending) | Shift + Enter |
Stop AI response | Esc |
Clear chat | Type /clear |
Delete chat | Type /delete |
Common first questions
"How do I add my OpenAI API key?"
Settings → SystemSculpt → Providers → OpenAI → Add your key → Save
"Can I use this offline?"
Yes! Install Ollama and select local models.
"Where are my chats saved?"
In SystemSculpt/Chats/
folder as JSON files for history, or as markdown when you export them.
"Is this free?"
Core features with your own API keys are free. Pro features (Agent Mode, embeddings, PDF processing, audio transcription) require a SystemSculpt license.
Try these features next
Now that you're chatting, try these:
-
Test Agent Mode (Pro)
- Enable it in chat settings (requires Pro license)
- Ask: "Create a new note called 'My Ideas' with a template"
-
Process a document (Pro)
- Drag a PDF into chat
- Ask: "Summarize this document"
-
Explore slash commands
- Type
/
in chat to see all commands - Try
/new
for new chat,/clear
to clear messages
- Type
-
Customize your setup
- Settings → SystemSculpt → AI Chat
- Set your default model
- Choose system prompt type
Pro tips from the community
💡 "Start simple" - Don't enable everything at once. Master chat first.
💡 "Use context" - Always drag relevant notes into chat for better responses.
💡 "Agent Mode is magic" - But start with read-only tasks before letting it write.
💡 "Join Discord" - Seriously, the community is incredibly helpful.
Troubleshooting common issues
Running into issues? Here's help:
-
Nothing happens when I click the message square icon → Reload Obsidian with
Ctrl/Cmd + R
-
"No models available" error → Check Settings → SystemSculpt → Providers and add at least one
-
AI seems confused about my notes → Make sure to drag notes into chat or use @ to reference them
-
Can't find a feature → Use Command Palette (
Ctrl/Cmd + P
) and search "SystemSculpt"
Join the community
You're not alone! Get help and share discoveries:
- 💬 Discord - Real-time help
- 📺 YouTube - Video tutorials
- 📧 Email Mike - Direct support
What's next?
- Master chat features - All the things you can do
- Set up providers - Detailed API key guide
- Enable Agent Mode - Let AI manage your vault (Pro)
- Configure settings - Make it yours
Welcome to SystemSculpt AI! Start exploring these powerful features to enhance your Obsidian workflow.