clausidian
Claude Code's Obsidian integration β AI agent toolkit for vault management, journal, notes, search, index sync, and more
Description
Claude Code's Obsidian integration β AI agent toolkit for vault management, journal, notes, search, index sync, and more
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 3.7.0 | Imported from npm (3.7.0) | Low | 4/21/2026 |
| v3.7.0 | ## Phase 3.7: Vector Embedding Search ### Features - **Semantic search** via TF-IDF sparse vectors + k-NN - CLI: `memory semantic <query> [--k N]` - MCP tool: `memory-semantic-search` - Zero external dependencies (reuses scoring.mjs) - Vault-version-aware caching ### What's New - EmbeddingStore class for k-NN search - SimilarityEngine.semanticSearch() method - MCP tool registration for Claude integration - All 394 tests passing ### Commits - 726cbd0: Vector embedding store foundation - 03fffd | Medium | 4/7/2026 |
| v3.5.0 | # Clausidian v3.5.0 β Deep Claude Code Integration ## Overview This release represents a comprehensive repositioning of Clausidian as **Claude Code's native Obsidian integration layer**, with four phases of deep integration completed. ## Major Features ### π Phase 1: Rebranding - Updated CLI description to emphasize Claude Code - README repositioned as Claude Code integration guide - Keywords prioritize Claude Code + MCP + Obsidian ### πͺ Phase 2: Hooks + MCP Enhancement (379 LOC) **New | Medium | 3/31/2026 |
| v3.0.1 | Hotfix: Optimize cache key generation performance. ## Performance Fix - Removed expensive Buffer + Base64 encoding in SearchCache._getCacheKey() - Switched to simple string concatenation - Performance improved 2x: 1000 keys now <5ms (was 19.67ms) All 398 tests passing β | Medium | 3/30/2026 |
| v3.0.0 | Major release with comprehensive performance optimization suite. ## What's New (v3.0.0) ### Performance Optimization Suite (Units 1-8) - **Unit 1:** File hashing for incremental sync detection - **Unit 2:** BM25 search index with caching - **Unit 3:** TF-IDF link suggestion scoring - **Unit 4:** Cluster caching with vault version invalidation - **Unit 5:** Selective cache invalidation per-note - **Unit 6:** Sampled pair suggestions (O(nΒ²) β ~1000 pairs cap) - **Unit 7:** Lazy body extraction | Medium | 3/30/2026 |
| v2.5.1 | ## Changes β¨ **Shell Script Quality Improvements** - **lib/common.sh**: New shared library eliminating 100+ lines of duplicate code - **All scripts updated**: install.sh, setup.sh, health.sh, verify.sh now use shared library - **Better error handling**: Added `set -o pipefail` to all scripts - **Unified logging**: Consistent log_success, log_error, log_warn functions - **Testing**: 18-item automated test suite (all passing) - **Documentation**: SCRIPT_STYLE.md (shell best practices), UPGRADE_SU | Medium | 3/30/2026 |
| v1.1.0 | ## What's New β macOS Features ### New Commands - **`open [note]`** β Open notes in Obsidian.app via `obsidian://` URI scheme (`--reveal` for Finder) - **`quicknote [prefix]`** β Capture clipboard (pbpaste/xclip/clip) as an idea note - **`launchd install|uninstall|status`** β macOS LaunchAgents for auto daily-backfill (23:30) + weekly-review (Sunday 20:00) ### New Flags - **`--copy`** β Copy search/read/graph results to clipboard - **`--reveal`** β Reveal in Finder instead of opening in Obsidi | Medium | 3/30/2026 |
| v0.6.0 | ## What's New ### One-Command Setup ```bash npm install -g obsidian-agent obsidian-agent init ~/my-vault obsidian-agent setup ~/my-vault ``` `setup` automatically: - Installs the `/obsidian` Claude Code skill - Registers the MCP server in `~/.claude/.mcp.json` - After restart, `/obsidian` works from any project ### Bundled /obsidian Skill - Intent router: maps natural language to the right MCP tool - 7 workflow patterns (daily journal, capture, review, search, maintenance) - Chinese + English | Medium | 3/27/2026 |
| v0.5.0 | ## What's New ### Read Command - `obsidian-agent read <note>` β read a note's full content - `obsidian-agent read <note> --section "TODO"` β read a specific heading section - Essential for agent workflows that need to inspect note content ### Delete Command - `obsidian-agent delete <note>` β remove a note file - Automatically cleans up `related` references in other notes - Rebuilds indices after deletion ### Recent Command - `obsidian-agent recent [days]` β show recently updated notes (defa | Medium | 3/27/2026 |
| v0.4.0 | ## What's New ### Vault Health Scoring `obsidian-agent health` scores your vault across 4 dimensions (0-100 each): - **Completeness** β frontmatter quality - **Connectivity** β links and relationships - **Freshness** β how recently updated - **Organization** β tags, types, naming ### Watch Mode `obsidian-agent watch` monitors vault directories and auto-rebuilds indices on file changes. Debounced to 500ms. ### Other - Health tool added to MCP server (now 16 tools) - 61 tests passing ## Instal | Medium | 3/27/2026 |
| v0.3.0 | ## What's New ### MCP Server - `obsidian-agent serve` β expose all vault operations as MCP tools via stdio transport - Compatible with Claude Desktop, Cursor, and any MCP-compatible AI assistant - 15 tools: journal, note, capture, search, list, backlinks, update, archive, patch, stats, orphans, graph, sync, tag_list, tag_rename ### JSON Output - All commands now support `--json` flag for machine-readable output - Enables reliable parsing by AI agents ### Heading-Level Patch - `obsidian-agent | Medium | 3/27/2026 |
Dependencies & License Audit
Loading dependencies...
Similar Packages
auxiliarAI agent for cloud service recommendations β Chrome-verified pricing, real gotchas, jobs, and community0.2.0
@vess-id/vessVESS local AI agent runtime β manages agent identity, permissions, and execution boundaries0.9.0
ecc-agentshieldSecurity auditor for AI agent configurations. Scans Claude Code setups for vulnerabilities, misconfigs, and injection risks.1.4.0
Awareness-LocalLocal-first AI agent memory β one command, works offline, no account needed. Give your Claude Code, Cursor, Windsurf, OpenClaw agent persistent memory. Markdown storage, hybrid search (FTS5 + embeddinmain@2026-04-20