Intelligent Markdown
Filesystem

$ pip install mdaifs

$ cd /path/to/your/markdown-repo

$ mdaifs status                          # stats: files, chunks, graph
$ mdaifs search "onboarding process"     # full-text search
$ mdaifs search "budget" --mode semantic  # vector similarity
$ mdaifs ls --department hr              # list with filters
$ mdaifs validate                        # check frontmatter schema
$ mdaifs freshness                       # find stale documents
$ mdaifs graph nina.scholz               # knowledge graph query
$ mdaifs impact hr                       # what breaks if HR changes?

$ pip install mdaifs            # core: CLI, BM25 search, graph, validation, freshness

$ mdaifs graph nina.scholz
# nina.scholz --[works_in]--> hr
# departments/hr/processes/recruiting.md --[has_owner]--> nina.scholz
# departments/hr/processes/recruiting.md --[has_tag]--> recruiting

$ mdaifs impact lisa.weber
# Affected documents (4):
#   departments/hr/processes/performance-review.md
#   departments/hr/policies/remote-work.md
#   ...
# Affected departments: hr
# Affected people: nina.scholz, markus.berger

from mdaifs import MdaifsRepo

repo = MdaifsRepo("/path/to/repo")

# Search
results = repo.search("onboarding", department="hr", top_k=5)
for r in results:
    print(f"[{r.score:.2f}] {r.file_path}: {r.heading}")

# Knowledge graph
for t in repo.graph_neighbors("nina.scholz", depth=2):
    print(f"  {t.subject} --[{t.predicate}]--> {t.obj}")

# Impact analysis
impact = repo.graph_impact("hr")
print(impact.affected_documents)
print(impact.affected_people)

# Freshness
for e in repo.freshness():
    if e.category == "overdue":
        print(f"  OVERDUE: {e.file_path} ({e.months_since:.0f} months)")

# List with filters
files = repo.list(department="hr", doc_type="process", status="active")

# Validate
errors = repo.validate()
assert len(errors) == 0, f"{len(errors)} validation errors"

$ mdaifs mcp-serve --repo /path/to/repo

{
  "mcpServers": {
    "mdaifs": {
      "command": "mdaifs",
      "args": ["mcp-serve", "--repo", "/path/to/repo"]
    }
  }
}

$ mdaifs serve --port 8900
# API docs: http://localhost:8900/docs

$ mkdir /mnt/company
$ mdaifs mount /path/to/repo /mnt/company

# Regular files pass through
$ cat /mnt/company/departments/hr/processes/recruiting.md

# Virtual .mdaifs/ directory for queries
$ cat /mnt/company/.mdaifs/status
$ cat /mnt/company/.mdaifs/freshness
$ cat /mnt/company/.mdaifs/search/budget+limits
$ cat /mnt/company/.mdaifs/graph/neighbors/nina.scholz
$ cat /mnt/company/.mdaifs/graph/impact/hr

# Extended attributes expose frontmatter
$ xattr -p user.mdaifs.owner recruiting.md        # nina.scholz
$ xattr -p user.mdaifs.department recruiting.md    # hr
$ xattr -p user.mdaifs.freshness recruiting.md     # 0.87

---
title: Recruiting Process          # required, string
owner: nina.scholz                 # required, firstname.lastname
type: process                      # required, enum
status: active                     # required, enum
created: 2024-08-10                # required, YYYY-MM-DD
department: hr                     # optional, enum
last-reviewed: 2026-03-25         # optional, used for freshness
tags: [recruiting, hiring]         # optional, array of strings
created-by: claude-code            # optional, marks AI-generated content
---