Reasonian embeds Reasonix — the native DeepSeek coding agent — into your Obsidian sidebar. It provides file read/write, search, shell commands, MCP tools, and multi-step workflows directly inside your vault.
Based on Claudian (MIT License), with the Claude backend replaced by Reasonix.
- 💬 Sidebar Chat — Multi-tab, streaming output, thinking block display
- 🧠 DeepSeek V4 — Flash / Pro models with reasoning effort control
- 🔧 Tool Set — File read/write, shell commands, web search, MCP servers
- 📝 Inline Editing — Select any text in a note, let the agent edit it
- 🎯 Plan Mode — Plan first, then execute — safe and controlled
- 🔄 Session Persistence — Messages saved to vault, survive restarts
- 🎨 Slash Commands —
/compact,/new,/model,/clearand more - 🌍 i18n — 10 languages supported
- 🧩 Custom System Prompt — Edit agent instructions in settings
- 💾 Long-Term Memory — REASONIX.md and user memory for cross-session knowledge
Not yet published to the Obsidian community plugin marketplace. Install manually.
- Download the latest
main.js,styles.css,manifest.jsonfrom Releases - Create a folder
.obsidian/plugins/reasonian/in your vault - Copy the three files into that folder
- Restart Obsidian
- Go to Settings → Community plugins → Turn off Safe Mode → Enable Reasonian
- Open Obsidian Settings → Reasonian
- Enter your API Key (get one from DeepSeek Platform)
- Optional settings:
- Model:
deepseek-v4-flash(fast) /deepseek-v4-pro(deep thinking) - Reasoning Effort: low / medium / high
- Custom System Prompt: additional instructions appended to every turn
- Long-Term Memory: auto-inject
REASONIX.mdand~/.reasonix/memory/ - Default Mode: Review (ask per action) / YOLO (auto-approve) / Plan (plan-then-execute)
- Model:
| Layer | Purpose | Details |
|---|---|---|
| app | Shared defaults & plugin storage | defaultSettings, ClaudianSettingsStorage, SharedStorageService |
| core | Provider-agnostic contracts | Runtime, registry, tools, types |
| providers/reasonix | Reasonix runtime adaptor | ChatRuntime impl, session service, tool registration, UI config |
| features/chat | Main sidebar chat UI | ClaudianView, controllers, renderers, state management |
| features/inline-edit | Inline edit modal | InlineEditModal |
| features/settings | Settings page | General + API config + system prompt |
| shared | Reusable UI components | Dropdowns, modals, mention UI, icons |
| i18n | Internationalization | 10 languages |
| utils | Cross-cutting utilities | Editor, path, markdown, diff, context, images |
| style | Modular CSS | Components, toolbar, features, settings, modals |
| Path | Contents |
|---|---|
.reasonix/sessions/{id}.messages.json |
Chat message persistence |
.reasonix/settings.json |
Plugin settings |
.reasonix/mcp.json |
MCP server configuration |
.reasonix/commands/**/*.md |
User slash commands |
.reasonix/skills/*/SKILL.md |
User skills |
~/.reasonix/memory/ |
User memory (global + per-project) |
REASONIX.md (vault root) |
Project memory |
git clone https://github.com/Reject-Reality/Reasonian.git
cd reasonian
# Build Reasonix dependency first
cd ../DeepSeek-Reasonix
npm install --ignore-scripts
npx tsup src/index.ts --format esm --dts --clean --sourcemap --target node22 --outDir dist
cd ../reasonian
npm run dev # Watch + auto-build
npm run build # Production build
npm run typecheck # TypeScript type checking- Claudian — Based on this excellent Obsidian plugin architecture
- Reasonix — DeepSeek-native coding agent engine
- DeepSeek — High-quality LLM API
MIT