🤖 claudian - Enhance your notes with intelligent agents

Claudian connects advanced artificial intelligence to your Obsidian vault. It acts as an assistant that understands your notes, writes code, and organizes your data. You use it to research topics, generate documents, and automate repetitive tasks inside your writing environment.

📥 How to download the software

Follow these steps to install the plugin on your Windows computer.

1. Go to the official release page.
2. Look for the assets section at the bottom of the latest release.
3. Select the file ending in .zip to start your download.
4. Keep this file in a folder you can find later.

⚙️ Installation steps

Obsidian manages plugins through a dedicated folder system. Perform these steps to move claudian into your workspace.

1. Open Obsidian on your desktop.
2. Click the gear icon in the bottom left corner to open Settings.
3. Select the Community plugins tab from the left menu.
4. Turn off Restricted mode if it remains active.
5. Click the folder icon next to Open plugin folder.
6. Extract the contents of the zip file you downloaded earlier into this folder.
7. Return to the plugin menu in Obsidian.
8. Click the Refresh button.
9. Locate claudian in the list and switch the toggle to On.

🛠️ System requirements

Your computer needs specific components to run this plugin without errors.

• Operating System: Windows 10 or Windows 11.
• Memory: 4 gigabytes of RAM or higher.
• Storage: 200 megabytes of free space for caching plugin data.
• Internet Connection: A stable connection for the agent to reach external models.
• Obsidian Version: 1.5.0 or newer.

🚀 Using the agent

The plugin adds a new icon to your side ribbon. Click this icon to open the chat window. The agent provides several capabilities to help you work faster.

Claude Code and Codex

These models help you write and debug code. You describe your task, and the agent suggests blocks of code or explains complex concepts. You insert these suggestions directly into your notes with one click.

MCP support

Model Context Protocol allows the agent to interact with other files and tools on your computer. You grant permission for the agent to read your specified folders, which creates a deeper connection between your local files and the artificial intelligence.

DeepSeek routing

If you prefer alternate models, the settings menu allows you to route requests through DeepSeek-compatible servers. Update the API endpoint in the plugin configuration to use this feature.

🔑 Setting up your API keys

This plugin requires an API key to communicate with external artificial intelligence services.

1. Open the claudian settings menu.
2. Find the field labeled API Key.
3. Paste a valid key from your chosen provider into this box.
4. Press Save.

The plugin stores this key locally on your machine. It never sends your key to unauthorized servers.

📝 Troubleshooting common issues

If the plugin fails to load or the agent does not respond, verify the following details.

• Plugin folder: Ensure you extracted the files directly into the folder indicated by Obsidian. Nested folders prevent the plugin from appearing in your menu.
• Internet access: Check that your firewall permits traffic from Obsidian.
• API key validity: Verify your key has remaining credit balance on the provider website.
• Software updates: Check the claudian repository for newer versions if you detect errors.

📋 General advice

• Start with short prompts to understand how the agent handles your requests.
• Organize your vault into folders to help the agent find information quickly.
• Review all code generated by the agent before you execute it on your computer.
• Use the clear history button if the chat window becomes cluttered.
• Create a backup of your vault before you use external tools to modify your files.

🛡️ Privacy and your data

Your notes remain on your computer. The plugin sends only the information you choose to share with the agent during a chat session. The agent does not read your entire vault unless you grant specific folder access through the MCP settings. You maintain control over which files the agent sees.

🔍 Understanding the features

• Research mode: The agent scans your existing notes to find links between topics.
• Draft mode: Provide an outline, and the agent writes a full draft for your review.
• Summarization: Highlight a long block of text and select the summarize command to create a brief overview.
• Search: Ask questions about your vault content to retrieve buried information.

💡 Support

Submit an issue on the GitHub repository if you find a bug. Provide the error message and the steps you took to trigger the event. This helps maintain the stability of the project for all users. You do not need to be a programmer to report an issue. Clear descriptions of the problem ensure the team can fix the mistake.

🌐 Community resources

Connect with other users on the official forum or via the discussions tab on GitHub. Users share tips about prompts, workflows, and configurations to get the most value from the claudian agent. Look through these threads to learn new ways to manage your information and increase your productivity.