# claude-obsidian | Agrici.Daniel | Knowledge Base | Instagit

Self-organizing AI second brain for Obsidian + Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathy's LLM Wiki pattern.

GitHub Stars: 12.7k

Repository: https://github.com/AgriciDaniel/claude-obsidian

---

## Articles

### [How Claude-Obsidian Determines Independence for High-Risk Claims](/AgriciDaniel/claude-obsidian/claude-obsidian-high-risk-claim-independence-determination)

Discover how Claude-Obsidian validates high-risk claims using identity set analysis and union-find grouping for ledger validation. Learn about determining independence for critical data.

- Tags: how-to-guide
- Published: 2026-08-29

### [Risks, Assessments, and Confidence Levels Defined for Claims in Claude-Obsidian](/AgriciDaniel/claude-obsidian/claude-obsidian-claim-risk-assessment-confidence)

Understand risks, assessments, and confidence levels for claims in Claude-Obsidian. Discover how the taxonomy centralizes and validates claim data.

- Tags: deep-dive
- Published: 2026-08-29

### [How Stable Source IDs Are Generated in Claude-Obsidian: A 3-Step Canonicalization Guide](/AgriciDaniel/claude-obsidian/claude-obsidian-stable-source-id-generation)

Learn how Claude-Obsidian generates stable source IDs with this 3-step canonicalization guide. Discover the process of creating deterministic identifiers for your Claude Obsidian data.

- Tags: how-to-guide
- Published: 2026-08-29

### [Claude-Obsidian Source Ledger Schemas and Kinds: A Complete Technical Reference](/AgriciDaniel/claude-obsidian/claude-obsidian-source-ledger-schemas-kinds)

Discover the claude-obsidian source ledger schemas and kinds. Learn about file, url, and manual sources, content types, authority levels, and review statuses for knowledge provenance.

- Tags: api-reference
- Published: 2026-08-29

### [Source Ledger Management in Claude-Obsidian: Architecture and Implementation](/AgriciDaniel/claude-obsidian/claude-obsidian-source-ledger-management)

Discover how Claude-Obsidian manages source ledger provenance using a JSON ledger with deterministic IDs and schema validation for robust data integrity. Learn the architecture and implementation details.

- Tags: architecture
- Published: 2026-08-29

### [URL Capture Validation Rules in Claude-Obsidian: A Deep Dive into Safe URL Handling](/AgriciDaniel/claude-obsidian/claude-obsidian-url-capture-validation-rules)

Explore Claude-Obsidian URL capture validation rules. Learn how it ensures safe handling by blocking credentials private networks and malformed URLs for secure data input.

- Tags: deep-dive
- Published: 2026-08-29

### [How the Capture Queue Manages Worker Claims in Claude-Obsidian](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-queue-worker-claims)

Learn how the Claude-Obsidian capture queue manages worker claims using atomic updates, random tokens, and strict validation to ensure exclusive task ownership.

- Tags: internals
- Published: 2026-08-29

### [Claude-Obsidian Capture Queue States: The Four States Every Entry Must Follow](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-queue-states)

Understand the four states queued claimed completed and failed for entries in the claude-obsidian capture queue. Learn how the source code enforces these states.

- Tags: internals
- Published: 2026-08-29

### [Understanding the Schema for the Capture Queue in Claude-Obsidian: A Technical Deep Dive](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-queue-schema)

Explore the claude-obsidian capture queue schema, schema version claude-obsidian capture queue v1. Learn about its essential fields: schema, revision, and entries for efficient file ingestion.

- Tags: deep-dive
- Published: 2026-08-29

### [Input, Network, and LLM Capabilities for Each Capture Adapter in Claude Obsidian](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-adapter-capabilities)

Explore Claude Obsidian's capture adapters discover input types network access and LLM capabilities for each ingestion method. Optimize your data workflow now.

- Tags: deep-dive
- Published: 2026-08-29

### [Capture Adapter Maturity States in Claude-Obsidian: The Complete Guide](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-adapter-maturity-states)

Understand Claude-Obsidian capture adapter maturity states Unimplemented Prototype Beta Stable Deprecated. Learn the readiness levels for each adapter in this complete guide.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Capture Adapters Are Declared in Claude-Obsidian: The Complete Guide](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-adapter-declaration)

Discover how capture adapters are declared in claude-obsidian using the centralized adapters.json manifest. Learn about adapter states, input constraints, and execution requirements for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-29

### [Where Are Captured Content Files Stored in Claude-Obsidian?](/AgriciDaniel/claude-obsidian/claude-obsidian-captured-content-storage)

Find out exactly where Claude-Obsidian stores captured content files. Learn about the .raw/captured subdirectory and the logic behind file storage in this guide.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Content-Addressing Works in the Claude-Obsidian Capture System](/AgriciDaniel/claude-obsidian/claude-obsidian-content-addressing-capture)

Learn how the Claude-Obsidian capture system uses content-addressing with SHA-256 hashes for deterministic paths, immutable storage, and automatic data deduplication.

- Tags: internals
- Published: 2026-08-29

### [Validation Steps for Source Capture in Claude-Obsidian: The 9-Stage Security Pipeline](/AgriciDaniel/claude-obsidian/claude-obsidian-source-capture-validation-steps)

Explore the 9-stage security pipeline for source capture validation in claude-obsidian. Learn how it ensures configuration integrity, path containment, filename safety, and more before vault entry.

- Tags: how-to-guide
- Published: 2026-08-29

### [How the Claude-Obsidian Capture System Implements Offline-First Primitives](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-system-offline-primitives)

Discover how the Claude-Obsidian capture system uses offline-first primitives with local filesystem operations atomic writes and SHA-256 checks for robust data management.

- Tags: internals
- Published: 2026-08-29

### [Complete Guide to Transaction Error Codes in Claude‑Obsidian](/AgriciDaniel/claude-obsidian/claude-obsidian-transaction-error-codes)

Master Claude-Obsidian transaction error codes. Understand 23 specific errors across four exception classes to diagnose and resolve issues from invalid paths to unsafe rollbacks.

- Tags: deep-dive
- Published: 2026-08-29

### [How the Plan Approval Hash Is Generated in Claude-Obsidian: SHA-256 Binding Explained](/AgriciDaniel/claude-obsidian/claude-obsidian-plan-approval-hash-generation)

Discover how the plan approval hash is generated in Claude-Obsidian. Learn about the SHA-256 binding process using transaction.py for secure transaction integrity.

- Tags: internals
- Published: 2026-08-29

### [Protected Paths in Claude-Obsidian Transaction Bundles: Security Boundaries Explained](/AgriciDaniel/claude-obsidian/claude-obsidian-protected-transaction-paths)

Discover protected paths in Claude-Obsidian transaction bundles. Learn which system paths like .git are secured against user overwrites with detailed explanations.

- Tags: security
- Published: 2026-08-29

### [Supported Operation Types in Claude-Obsidian Transactions: Complete Reference](/AgriciDaniel/claude-obsidian/claude-obsidian-transaction-operation-types)

Discover the 13 supported operation types in Claude-Obsidian transactions for strict vault mutation control. Explore save, ingest, lint-fix, and migration operations.

- Tags: api-reference
- Published: 2026-08-29

### [What Are the Guarantees of the Claude-Obsidian Transaction System?](/AgriciDaniel/claude-obsidian/claude-obsidian-transaction-system-guarantees)

Discover the guarantees of the claude-obsidian transaction system: atomic, recoverable, and isolated operations. Learn about its features ensuring vault consistency.

- Tags: deep-dive
- Published: 2026-08-29

### [Vault Selection Order for claude-obsidian: How the Tool Locates Your Notes](/AgriciDaniel/claude-obsidian/claude-obsidian-vault-selection-order)

Understand the claude-obsidian vault selection order. Discover how the tool prioritizes paths through CLI arguments environment variables workspace config and more for efficient note access.

- Tags: how-to-guide
- Published: 2026-08-29

### [How claude-obsidian Separates the Product Repository from the User Vault](/AgriciDaniel/claude-obsidian/how-does-claude-obsidian-separate-product-repo-user-vault)

Discover how claude-obsidian separates product code from user vaults using hierarchical discovery, filesystem checks, and clear documentation. Learn about its robust security.

- Tags: architecture
- Published: 2026-08-29

### [How claude-obsidian Builds Deterministic ZIP Artifacts: A 9-Step Reproducible Pipeline](/AgriciDaniel/claude-obsidian/claude-obsidian-build-deterministic-zip-artifacts)

Learn how claude-obsidian builds deterministic ZIP artifacts with a 9 step reproducible pipeline. Discover Git blob verification, fixed timestamps, and ZIP_STORED compression for byte-identical releases.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Claim Assessments Are Validated in claude-obsidian: A Technical Deep Dive into Ledger Integrity](/AgriciDaniel/claude-obsidian/claude-obsidian-claim-assessment-validation)

Discover how claude-obsidian validates claim assessments using a rule-based workflow in ledgers.py. Learn about state constraints, evidence freshness, and risk-based independence.

- Tags: deep-dive
- Published: 2026-08-28

### [Which Paths Are Reserved and Protected from User-Authored Bundles in Claude-Obsidian](/AgriciDaniel/claude-obsidian/claude-obsidian-reserved-paths-user-bundles)

Discover which paths are protected from user-authored bundles in Claude-Obsidian. Learn about reserved directories like .claude-obsidian.json, wiki, and config to maintain vault integrity.

- Tags: how-to-guide
- Published: 2026-08-28

### [Bundle Schema for Transactions in Claude-Obsidian: Complete JSON Reference](/AgriciDaniel/claude-obsidian/claude-obsidian-bundle-schema-transactions)

Explore the bundle schema for transactions in claude-obsidian. Understand the JSON contract for atomic vault changes, versioning, and SHA-256 verification. Get the complete reference.

- Tags: api-reference
- Published: 2026-08-28

### [How Claude‑Obsidian Resolves Vault Locations: Precedence Rules and Safety Mechanisms](/AgriciDaniel/claude-obsidian/claude-obsidian-resolve-vault-locations)

Discover how claude-obsidian resolves vault locations using a 7-step algorithm that prioritizes explicit arguments, environment variables, and workspace config for safe, deterministic discovery.

- Tags: how-to-guide
- Published: 2026-08-28

### [How to Initialize a New Claude-Obsidian Vault: Step-by-Step Setup Guide](/AgriciDaniel/claude-obsidian/how-to-initialize-new-claude-obsidian-vault)

Initialize a new Claude-Obsidian vault with our step-by-step guide. Learn the two-step review-and-apply workflow for SHA-256 hashed transaction plans before disk writes.

- Tags: getting-started
- Published: 2026-08-28

### [URL Safety Restrictions for Remote Sources in claude-obsidian: A Complete Security Guide](/AgriciDaniel/claude-obsidian/claude-obsidian-url-safety-remote-sources)

Learn claude-obsidian URL safety restrictions for remote sources. Discover HTTPS-only endpoints, localhost blocking, and explicit consent requirements to prevent data leakage. Secure your remote connections now.

- Tags: security-guide
- Published: 2026-08-28

### [How Claude-Obsidian Ensures Path Safety for Vault Operations: 6 Layers of Filesystem Defense](/AgriciDaniel/claude-obsidian/claude-obsidian-path-safety-vault-operations)

Discover how Claude-Obsidian ensures path safety with 6 filesystem defense layers. Learn about canonicalization, access restriction, symlink blocking, and more for secure vault operations.

- Tags: security-best-practices
- Published: 2026-08-28

### [What Issues Does the Claude-Obsidian Lint Workflow Detect?](/AgriciDaniel/claude-obsidian/claude-obsidian-lint-workflow-detected-issues)

Discover the 11 structural defects the claude-obsidian lint workflow detects in your Obsidian vaults, including dead links, orphan pages, and missing frontmatter. Get detailed reports.

- Tags: how-to-guide
- Published: 2026-08-28

### [What Happens During the Save Workflow in Claude-Obsidian: A 4-Stage Atomic Pipeline](/AgriciDaniel/claude-obsidian/claude-obsidian-save-workflow)

Discover the claude-obsidian save workflow. Learn how its 4-stage atomic pipeline ensures validated, auditable, and user-confirmed vault modifications before commitment.

- Tags: internals
- Published: 2026-08-28

### [How the Claude-Obsidian Query Workflow Works: BM25 and Neural Reranking Explained](/AgriciDaniel/claude-obsidian/claude-obsidian-query-workflow)

Discover the Claude-Obsidian query workflow. Learn how BM25 indexing and neural reranking retrieve answers from your vault without file modification.

- Tags: deep-dive
- Published: 2026-08-28

### [Ingest Workflow in Claude-Obsidian: 7-Stage Pipeline Explained](/AgriciDaniel/claude-obsidian/claude-obsidian-ingest-workflow)

Discover the Claude-Obsidian ingest workflow, a 7-stage pipeline transforming raw data into structured knowledge. Learn how this agent enriches your vault.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Captures Are Stored and Prevented from Duplication in Claude‑Obsidian](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-storage-deduplication)

Discover how Claude-Obsidian stores captures as immutable files and prevents duplication using SHA-256 hash checks. Ensure your data integrity and efficiency.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Claude-Obsidian Handles Offline-First Source Ingestion: A Technical Deep Dive](/AgriciDaniel/claude-obsidian/claude-obsidian-offline-first-source-ingestion)

Explore how Claude Obsidian manages offline-first source ingestion. Discover its read-only workflow and atomic draft bundle application.

- Tags: deep-dive
- Published: 2026-08-28

### [Claim Ledger in claude-obsidian: Data Structure, Validation, and Evidence Tracking](/AgriciDaniel/claude-obsidian/claude-obsidian-claim-ledger-information)

Discover how the claim ledger in claude-obsidian stores falsifiable statements, risk classifications, and evidence for auditable knowledge management in Obsidian.

- Tags: deep-dive
- Published: 2026-08-28

### [What Information Is Stored in the Source Ledger in claude-obsidian](/AgriciDaniel/claude-obsidian/claude-obsidian-source-ledger-information)

Discover what the source ledger in claude-obsidian stores: SHA-256 hashes, page references, and metadata. Build immutable audit trails and enable selective re-ingestion for compound vaults.

- Tags: internals
- Published: 2026-08-28

### [How to Apply a Transaction Bundle in Claude-Obsidian: CLI and Python Guide](/AgriciDaniel/claude-obsidian/how-to-apply-transaction-bundle-claude-obsidian)

Learn to apply a transaction bundle in Claude-Obsidian using CLI commands or Python. Safely mutate your vault with rollback guarantees.

- Tags: how-to-guide
- Published: 2026-08-28

### [Platform Requirements for Running Claude-Obsidian Mutations](/AgriciDaniel/claude-obsidian/claude-obsidian-platform-requirements-mutations)

Discover the essential platform requirements for running Claude-Obsidian mutations. Learn about POSIX compatibility, Python 3.11+, Bash, and filesystem needs for smooth operation.

- Tags: how-to-guide
- Published: 2026-08-28

### [How the Claude-Obsidian Transaction System Ensures Data Integrity](/AgriciDaniel/claude-obsidian/claude-obsidian-transaction-system-data-integrity)

Discover how the Claude-Obsidian transaction system guarantees data integrity with locking, cryptographic verification, atomic replacements, and rollback journals. Prevent data loss.

- Tags: internals
- Published: 2026-08-28

### [Supported Note Organization Modes in claude-obsidian: A Complete Guide to PARA, LYT, Zettelkasten, and Generic](/AgriciDaniel/claude-obsidian/claude-obsidian-supported-note-organization-modes)

Explore supported note organization modes in claude-obsidian: PARA LYT Zettelkasten and Generic. Discover the best way to structure your Obsidian notes for efficient knowledge management.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Claude-Obsidian Separates Vault Data from Plugin Installation](/AgriciDaniel/claude-obsidian/claude-obsidian-manage-vault-data-plugin-separation)

Discover how Claude-Obsidian separates vault data from plugin installation with strict isolation and explicit rejection logic. Learn more about AgriciDaniel/claude-obsidian.

- Tags: internals
- Published: 2026-08-28

### [Difference Between init and adopt in claude-obsidian: A Technical Guide](/AgriciDaniel/claude-obsidian/difference-between-init-and-adopt-claude-obsidian)

Understand the difference between init and adopt in claude-obsidian. Learn how init creates new vaults and adopt integrates with existing folders without altering your notes.

- Tags: technical-guide
- Published: 2026-08-28

### [How to Set Up claude-obsidian with an Existing Obsidian Vault](/AgriciDaniel/claude-obsidian/how-to-set-up-claude-obsidian-with-existing-obsidian-vault)

Easily set up claude-obsidian with your existing Obsidian vault using the adopt command. Safely add scaffolding files without altering your notes. Learn how now.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Claude-Obsidian Performs Deterministic Ledger Validation for a Given Audit Date](/AgriciDaniel/claude-obsidian/how-does-claude-obsidian-perform-deterministic-ledger-validation-for-a-given-audit-date)

Learn how claude-obsidian ensures bit-for-bit reproducible verification with deterministic ledger validation for any audit date. It uses a pure functional pipeline for dependency-free results.

- Tags: how-to-guide
- Published: 2026-08-26

### [Validation Rules for Accepted Claims with Fresh Contradictory Evidence in Claude-Obsidian](/AgriciDaniel/claude-obsidian/what-are-the-validation-rules-for-accepted-claims-with-fresh-contradictory-evidence-in-claude-obsidian)

Discover validation rules for accepted claims in Claude-Obsidian. Learn how the ledger validator enforces non-empty adjudication notes with fresh contradictory evidence.

- Tags: how-to-guide
- Published: 2026-08-26

### [How Claude-Obsidian Enforces High-Risk Acceptance Claims with Independent Sources](/AgriciDaniel/claude-obsidian/how-does-claude-obsidian-handle-high-risk-acceptance-claims-and-independent-sources)

Discover how Claude-Obsidian enforces high-risk acceptance claims by requiring at least two independent sources. Learn about the validation process and safeguard your data.

- Tags: how-to-guide
- Published: 2026-08-26

### [Critical Validation Rules for Accepted Claims in Claude-Obsidian](/AgriciDaniel/claude-obsidian/what-are-the-critical-validation-rules-for-accepted-claims-in-claude-obsidian)

Learn critical validation rules for accepted claims in Claude-Obsidian. Ensure valid timestamps, fresh evidence, and corroboration for high-risk claims.

- Tags: best-practices
- Published: 2026-08-26

### [Evidence Relations in the Claude-Obsidian Claim Ledger: The Three Valid Types](/AgriciDaniel/claude-obsidian/what-are-the-evidence-relations-used-in-the-claude-obsidian-claim-ledger)

Discover the three valid evidence relations supports contradicts and context in the Claude-Obsidian claim ledger. Learn how they ensure semantic integrity.

- Tags: deep-dive
- Published: 2026-08-26

### [Claim Assessment Types in claude-obsidian: A Complete Guide to the Five Canonical Values](/AgriciDaniel/claude-obsidian/what-are-the-claim-assessment-types-in-claude-obsidian)

Explore the five claim assessment types in claude-obsidian: accepted, provisional, contested, unsupported, and deprecated. Learn how this Obsidian plugin standardizes claim evaluation for your knowledge base.

- Tags: how-to-guide
- Published: 2026-08-26

### [How the Claim Ledger Connects Source Evidence to Knowledge Assertions in Claude-Obsidian](/AgriciDaniel/claude-obsidian/how-does-the-claim-ledger-in-claude-obsidian-connect-source-evidence-to-knowledge-assertions)

Discover how the claim ledger in Claude-Obsidian links source evidence to knowledge assertions using stable IDs and JSON arrays. Learn about provenance, freshness, and independence.

- Tags: architecture
- Published: 2026-08-26

### [Validation Rules for Active File Sources in Claude‑Obsidian: 5 Critical Integrity Checks](/AgriciDaniel/claude-obsidian/what-are-the-validation-rules-for-active-file-sources-in-claude-obsidian)

Discover the 5 critical validation rules for active file sources in Claude-Obsidian. Ensure data integrity with essential checks for file existence, SHA-256 hashes, and valid page strings.

- Tags: how-to-guide
- Published: 2026-08-26

### [How Claude-Obsidian Handles Synthetic Content and Authority Declaration: Validation Rules and Implementation](/AgriciDaniel/claude-obsidian/how-does-claude-obsidian-handle-synthetic-content-and-authority-declaration)

Discover how Claude-Obsidian handles synthetic content and authority declaration with strict validation rules. Learn about its implementation in the AgriciDaniel/claude-obsidian repository and avoid ledger validation errors.

- Tags: deep-dive
- Published: 2026-08-26

### [How to Identify Active Sources in the Claude-Obsidian Source Ledger: 6 Provenance Rules Explained](/AgriciDaniel/claude-obsidian/what-are-the-rules-for-active-sources-in-the-claude-obsidian-source-ledger)

Discover the 6 provenance rules for active sources in the Claude-Obsidian source ledger, including immutability, authority, freshness, and live backlinks. Validate claims effectively.

- Tags: how-to-guide
- Published: 2026-08-26

### [Review Statuses for Sources in the Claude-Obsidian Ledger: The Complete Guide](/AgriciDaniel/claude-obsidian/what-are-the-review-statuses-for-sources-in-the-claude-obsidian-ledger)

Master Claude-Obsidian review statuses: unreviewed, active, superseded, and rejected. Understand source reliability and workflow in this complete guide.

- Tags: how-to-guide
- Published: 2026-08-26

### [Authority Levels for Sources in claude-obsidian: The Complete Provenance Guide](/AgriciDaniel/claude-obsidian/what-are-the-authority-levels-for-sources-in-claude-obsidian)

Understand claude-obsidian source authority levels official primary secondary community synthetic and unknown to categorize trustworthiness in your source ledger.

- Tags: deep-dive
- Published: 2026-08-26

### [Content Kinds in the claude-obsidian Source Ledger: Complete Enumeration and Validation Guide](/AgriciDaniel/claude-obsidian/what-are-the-content-kinds-that-can-be-tracked-in-the-claude-obsidian-source-ledger)

Discover the ten content kinds tracked in the claude-obsidian source ledger document webpage dataset image audio video code conversation synthetic other. Learn validation methods.

- Tags: deep-dive
- Published: 2026-08-26

### [Claude-Obsidian Source Kinds: File, URL, and Manual Types Explained](/AgriciDaniel/claude-obsidian/what-are-the-different-source-kinds-recognized-by-claude-obsidian)

Explore Claude-Obsidian source kinds: file, url, and manual. Understand how each type integrates knowledge into your vault and applies authority levels for seamless processing. Learn more now.

- Tags: how-to-guide
- Published: 2026-08-26

### [Reserved Paths in Claude-Obsidian: What User-Authored Bundles Cannot Overwrite](/AgriciDaniel/claude-obsidian/what-are-the-reserved-paths-in-claude-obsidian-that-user-authored-bundles-cannot-replace)

Discover reserved paths in Claude-Obsidian that user-authored bundles cannot overwrite. Learn how this feature enforces data integrity and protects your setup.

- Tags: deep-dive
- Published: 2026-08-26

### [How claude-obsidian Generates a Canonical Hash for Operation Approval Using `plan_approval_sha256`](/AgriciDaniel/claude-obsidian/how-does-claude-obsidian-generate-a-canonical-hash-for-operation-approval-using-plan_approval_sha256)

Discover how claude-obsidian generates a canonical hash for operation approval with plan_approval_sha256. Learn how it ensures exact reviewed changes are executed for secure transactions.

- Tags: how-to-guide
- Published: 2026-08-26

### [How `inspect_bundle` Validates Write Bundles Without Mutation in Claude-Obsidian](/AgriciDaniel/claude-obsidian/how-does-inspect_bundle-validate-write-bundles-without-mutation-in-claude-obsidian)

Learn how claude-obsidian's inspect_bundle validates write bundles without mutation. It uses temporary directories and vault snapshots for safe, zero-side-effect verification.

- Tags: internals
- Published: 2026-08-26

### [Transaction System in claude-obsidian: Architecture and Implementation](/AgriciDaniel/claude-obsidian/what-are-the-key-components-of-the-transaction-system-in-claude-obsidian)

Explore the claude-obsidian transaction system. Discover its architecture and implementation, focusing on schema validation, file locking, atomic writes, and rollback for reliable vault updates. Learn more!

- Tags: architecture
- Published: 2026-08-26

### [How claude-obsidian Ensures Transactional Integrity for Vault Mutations](/AgriciDaniel/claude-obsidian/how-does-claude-obsidian-ensure-transactional-integrity-for-vault-mutations)

Discover how claude-obsidian ensures transactional integrity for vault mutations. Learn about its atomic, recoverable protocol combining locking, pre-validation, and rollback.

- Tags: architecture
- Published: 2026-08-26

### [Claude-Obsidian URL Safety Validation Rules: How the Tool Validates URLs Before Capture](/AgriciDaniel/claude-obsidian/claude-obsidian-capture-url-safety-validation)

Learn how Claude-Obsidian validates URLs before capture. Discover rules for preventing credential leaks, blocking unsafe schemes, and rejecting private networks.

- Tags: how-to-guide
- Published: 2026-08-26

### [How Claude-Obsidian Implements Content-Addressed Storage for Captured Sources](/AgriciDaniel/claude-obsidian/claude-obsidian-content-addressed-storage-capture)

Discover how Claude-Obsidian leverages content-addressed storage with SHA-256 hashes for efficient knowledge graph management. Ensure deduplication, stable referencing, and integrity.

- Tags: internals
- Published: 2026-08-26

### [What Are the Assessment States for Claims in Claude-Obsidian?](/AgriciDaniel/claude-obsidian/claude-obsidian-claim-assessment-states)

Discover the five assessment states for claims in Claude-Obsidian: accepted, provisional, contested, unsupported, and deprecated. Understand claim reliability and evidentiary status in your vault.

- Tags: api-reference
- Published: 2026-08-26

### [How Claims Are Tracked and Assessed in Claude-Obsidian's Claim Ledger](/AgriciDaniel/claude-obsidian/claude-obsidian-claim-ledger-tracking-and-assessment)

Discover how Claude-Obsidian's claim ledger tracks and assesses falsifiable statements with metadata like risk levels and evidence links. Learn about its validation rules for integrity and freshness.

- Tags: how-to-guide
- Published: 2026-08-26

### [What Are the Possible Values for review_status in Claude-Obsidian?](/AgriciDaniel/claude-obsidian/claude-obsidian-source-ledger-review-status-values)

Explore the four possible review_status values unreviewed active superseded and rejected in the Claude-Obsidian source ledger to manage your notes effectively.

- Tags: api-reference
- Published: 2026-08-26

### [Where Is the Claude-Obsidian Source Ledger Stored? Schema and Fields Explained](/AgriciDaniel/claude-obsidian/claude-obsidian-source-ledger-storage-and-fields)

Discover where the Claude-Obsidian source ledger is stored and explore its schema fields including uri, type, and retrieved. Learn about its structure within your vault.

- Tags: internals
- Published: 2026-08-26

### [Which Paths Are Protected from User-Authored Bundles in Claude-Obsidian](/AgriciDaniel/claude-obsidian/protected-paths-claude-obsidian-user-bundles)

Discover which paths are protected from user-authored bundles in Claude-Obsidian. Learn how the assert_not_plugin_tree function secures your plugin installation from unauthorized writes.

- Tags: how-to-guide
- Published: 2026-08-26

### [How to Perform Read-Only Operations on Windows with Claude-Obsidian](/AgriciDaniel/claude-obsidian/claude-obsidian-windows-read-only-operations)

Learn how to perform read-only operations on Windows with Claude-Obsidian. Inspect, preview, and retrieve data safely while avoiding vault mutations on unsupported platforms.

- Tags: how-to-guide
- Published: 2026-08-25

### [How the Claude-Obsidian Mutation Protocol Works: A 5-Step Transaction Workflow](/AgriciDaniel/claude-obsidian/claude-obsidian-mutation-protocol-workflow)

Explore the Claude-Obsidian mutation protocol workflow. Discover how pre-condition hashing, parallel drafting, and atomic bundling ensure safe and auditable vault updates in 5 steps.

- Tags: deep-dive
- Published: 2026-08-25

### [Schema for Transactions in Claude-Obsidian: The Complete Developer Guide](/AgriciDaniel/claude-obsidian/claude-obsidian-transaction-schema)

Understand the Claude-Obsidian transaction schema. Learn about BUNDLE_SCHEMA, RESULT_SCHEMA, and JOURNAL_SCHEMA for atomic vault modifications.

- Tags: developer-guide
- Published: 2026-08-25

### [What Happens When Claude-Obsidian Cannot Select a Vault: Error Handling and Fail-Closed Design](/AgriciDaniel/claude-obsidian/what-happens-if-claude-obsidian-cannot-select-vault)

Claude-Obsidian raises a VaultSelectionError and exits if it cannot select a vault. Learn about its fail-closed design and error handling to secure your operations.

- Tags: how-to-guide
- Published: 2026-08-25

### [How Claude-Obsidian Resolves Vault Selection: A Precedence-Based Algorithm](/AgriciDaniel/claude-obsidian/claude-obsidian-vault-selection-resolution)

Discover how Claude-Obsidian resolves vault selection using a seven-step precedence algorithm. Learn how it prioritizes explicit args, env vars, workspace configs, and directory discovery.

- Tags: how-to-guide
- Published: 2026-08-25

### [Claude-Obsidian Product vs User Vault: Architecture and Setup Guide](/AgriciDaniel/claude-obsidian/product-vs-user-vault-claude-obsidian)

Understand the Claude-Obsidian product vs user vault architecture. Learn how immutable app code and your personal knowledge files interact for seamless organization.

- Tags: architecture
- Published: 2026-08-25

### [How Agent Skills Are Integrated into Claude-Obsidian: Architecture and Implementation](/AgriciDaniel/claude-obsidian/how-agent-skills-integrated-into-claude-obsidian)

Discover how Claude-Obsidian integrates Agent Skills. Learn about self-describing SKILL.md files, validation, and secure execution within strict vault boundaries.

- Tags: architecture
- Published: 2026-08-25

### [How Claude-Obsidian Implements Safe Concurrency During Vault Mutations](/AgriciDaniel/claude-obsidian/claude-obsidian-safe-concurrency-mechanisms)

Discover how Claude-Obsidian ensures safe concurrency during vault mutations. Learn about its MutationLock, atomic directory creation, inode verification, and bundle hashing for a robust one-writer protocol.

- Tags: internals
- Published: 2026-08-25

### [How Claude-Obsidian Ensures Provenance Awareness in Notes: A Technical Deep Dive](/AgriciDaniel/claude-obsidian/how-claude-obsidian-ensures-provenance-awareness)

Discover how Claude Obsidian ensures provenance awareness with immutable ledgers, stable identifiers, and transaction validation for verifiable evidence. Learn more.

- Tags: deep-dive
- Published: 2026-08-25

### [What Are Source-Cited Claims in Claude-Obsidian?](/AgriciDaniel/claude-obsidian/what-does-source-cited-claims-mean-in-claude-obsidian)

Discover what source-cited claims mean in Claude-Obsidian. Learn how this system links statements to verifiable sources for immutable provenance. AgriciDaniel/claude-obsidian.

- Tags: deep-dive
- Published: 2026-08-25

### [How Claude-Obsidian Implements Local-First Knowledge Bases](/AgriciDaniel/claude-obsidian/how-claude-obsidian-handles-local-first-knowledge-bases)

Discover how Claude-Obsidian builds local-first knowledge bases. Your Markdown files stay user-owned and editable using explicit roots and atomic mutations for safe, non-destructive workflows.

- Tags: internals
- Published: 2026-08-25