Note Companion is an AI-powered Obsidian plugin that automatically organizes and formats your notes—so you don’t have to.
- 🗂️ Organizing Suggestions: Get AI-driven suggestions for folders, tags, filenames, and more.
- 🎛️ Custom Format AI Prompts: Save and apply your own AI prompts for consistency.
- 📁 Automated Workflows: Streamline your file management and formatting tasks.
- 📖 Handwritten Note Digitization: Convert handwritten notes into searchable digital text.
- 🔊 Audio Transcription: Easily transcribe and organize audio files.
- ✂️ Atomic Note Generation: Break down larger notes into smaller, more focused ones.
- 🎥 YouTube Summaries: Quickly generate summaries for YouTube videos.
- 💬 Context-Aware AI Chat: Use AI to chat with multiple notes in context.
Transform your Obsidian vault into an intelligent knowledge base:
- Context-Aware Organization: AI suggests tags, folders, and filenames based on content.
- Powerful Search: Natural language search across files, including YouTube transcripts.
- Automation Tools:
LastModifiedHandler
: Track and organize recently modified files.ScreenpipeHandler
: Monitor daily activities.ExecuteActionsHandler
: Automate repetitive tasks.
- Advanced OCR Integration: Convert handwritten notes and diagrams into digital text.
- Batch Processing: Automate organization for multiple notes at once.
- Diagram Recognition: Preserve and process hand-drawn diagrams.
- Granola-Style Notes: Automatically create structured and actionable meeting notes.
- Smart Transcript Integration: Merge meeting transcripts with existing notes.
- Customizable Templates: Ensure consistent formatting for all notes.
Choose your preferred setup:
- Access our managed service with all features included
- No setup required - just activate your license key
- Regular updates and new features
-
Run your own instance with full control
-
Use your preferred AI models
-
Complete privacy with local processing
-
Run the server For Linux/macOS:
cd packages/web && pnpm build:self-host && pnpm start
And make sure you have your
OPENAI_API_KEY
variable set up in your.env.local
file inside thepackages/web
directory. If you want to use Amazon Bedrock models, you'll also need to configure AWS credentials (AWS_ACCESS_KEY_ID
,AWS_SECRET_ACCESS_KEY
,AWS_REGION
). For Windows (PowerShell):cd packages/web; pnpm build:self-host; pnpm start
And make sure you have your
OPENAI_API_KEY
variable set up in your.env.local
file inside thepackages/web
directory.
This is a monorepo using pnpm workspaces and Turborepo. To get started:
- Install dependencies:
pnpm install
- Build all packages:
pnpm build
- Development commands:
- Start web development server:
cd packages/web && pnpm dev
- Build plugin:
cd packages/plugin && pnpm build
- Build audio server:
cd packages/audio-server && pnpm build
The project consists of the following packages:
- Start web development server:
packages/plugin
: The Obsidian pluginpackages/web
: The web applicationpackages/audio-server
: Audio transcription serverpackages/shared
: Shared utilities and types For the tech-savvies who would like to play around with different models, there is a promptfoo.yaml file in the project including examples with local LLMs. See link for more info: https://promptfoo.dev/docs/configuration/guide/
Seamlessly integrate with your mobile workflow:
- iOS Shortcut for sending Apple Notes to Obsidian
- Voice memo support for instant meeting notes
- Cloud sync compatibility (works great with iCloud)
The iOS shortcut below makes it easy for you to easily work from your phone with this plugin. https://www.icloud.com/shortcuts/06915768862848fb9711f2f19b6405e2 how to set it up: https://youtu.be/zWJgIRlDWkk?si=HSeOUKaMfJvaLtKI
Notes:
- It works when your vault is on a cloud drive. I use it with iCloud and works great. Doesn't work with OneDrive last time I tested.
- Currently only works if your iOS is in English. But if you reach out on discord I can help you set it up in your language.
Create powerful automation workflows:
- Define custom processing rules
- Set up automatic file naming conventions
- Configure content formatting templates
Process various types of content:
- Audio transcription
- Image OCR
- PDF text extraction
- YouTube video transcripts
Get suggestions and choose what to apply with the Assistant view. Here's how to use it:
- Click on the Assistant View Icon or set up the "Show Assistant" hotkey to open the Sidebar
- Select any of your files and choose which changes to apply

Auto-organize with the AI Inbox.
We recommend the AI Assistant view for more control. But the AI Inbox can be handy as well. Simply move any of your files to the "Inbox" folder and the plugin will automatically move it to the folder it belongs. Additional configuration can also be specified within the plugin settings (e.g. auto-tagging, auto-formatting).
Move your unorganized files into _FileOrganizer2000/Inbox
It takes a sec, and then renames, and organizes your file.
See plugin settings to customize the changes AI Inbox applies to your files.
Give instructions for the AI to format and modify your files.
See video: https://www.youtube.com/watch?v=rommuUXRgUw&t=17s
To use llama 3.2 with the ai chat, install Ollama + llama 3.2 and check this setting in the plugin:
