obsidian-wiki 2026.5.2__tar.gz

obsidian_wiki-2026.5.2/.agent/rules/obsidian-wiki.md

@@ -0,0 +1,44 @@
+---
+alwaysApply: true
+description: Obsidian Wiki skill-based framework — routing, conventions, and core rules.
+---
+
+# Obsidian Wiki — Agent Context
+
+This project is a **skill-based framework** for building and maintaining an Obsidian knowledge base.
+
+## Quick Orientation
+
+1. Read `~/.obsidian-wiki/config` (or `.env` in this repo) for `OBSIDIAN_VAULT_PATH` — this is where the wiki lives.
+2. Read `.manifest.json` at the vault root to see what's already been ingested.
+3. Skills are in `.skills/` (also at `.agents/skills/`). Each subfolder has a `SKILL.md`.
+
+## When to Use Skills
+
+| User says something like… | Read this skill |
+|---|---|
+| "set up my wiki" / "initialize" | `wiki-setup` |
+| "ingest" / "add this to the wiki" | `wiki-ingest` |
+| "import my Claude history" | `claude-history-ingest` |
+| "import my Codex history" | `codex-history-ingest` |
+| "import my Hermes history" | `hermes-history-ingest` |
+| "import my OpenClaw history" | `openclaw-history-ingest` |
+| "import my Pi history" | `pi-history-ingest` |
+| "process this export" / "ingest this data" | `data-ingest` |
+| "what's the status" / "show the delta" | `wiki-status` |
+| "what do I know about X" | `wiki-query` |
+| "audit" / "lint" / "find broken links" | `wiki-lint` |
+| "rebuild" / "archive" / "restore" | `wiki-rebuild` |
+| "link my pages" / "cross-reference" | `cross-linker` |
+| "fix my tags" | `tag-taxonomy` |
+| "update wiki" / "sync to wiki" | `wiki-update` |
+| "export wiki" / "export graph" | `wiki-export` |
+
+## Core Rules
+
+- **Compile, don't retrieve** — update existing pages, don't append or duplicate.
+- **Track everything** — update `.manifest.json`, `index.md`, and `log.md` after every operation.
+- **Connect with `[[wikilinks]]`** — every page should link to related pages.
+- **Frontmatter required** — every page needs `title`, `category`, `tags`, `sources`, `created`, `updated`.
+
+For full context, read `AGENTS.md` at the repo root.

obsidian_wiki-2026.5.2/.agent/workflows/obsidian-wiki.md

@@ -0,0 +1,29 @@
+---
+name: obsidian-wiki
+description: Obsidian wiki workflows — query, update, ingest, lint, status.
+commands:
+  - name: wiki-query
+    description: Answer questions from the compiled Obsidian wiki with [[wikilink]] citations.
+    skill: .skills/wiki-query/SKILL.md
+  - name: wiki-update
+    description: Sync the current project's knowledge into the Obsidian wiki.
+    skill: .skills/wiki-update/SKILL.md
+  - name: wiki-ingest
+    description: Ingest documents into the Obsidian wiki.
+    skill: .skills/wiki-ingest/SKILL.md
+  - name: wiki-status
+    description: Show what's been ingested, what's pending, and the delta.
+    skill: .skills/wiki-status/SKILL.md
+  - name: wiki-lint
+    description: Audit the wiki for orphans, broken links, stale content.
+    skill: .skills/wiki-lint/SKILL.md
+---
+
+# Obsidian Wiki — Workflow Registry
+
+Each command above maps to a `SKILL.md` in `.skills/`. When a user invokes one
+of these commands, read the mapped skill file and follow its instructions
+exactly. The skills handle vault path resolution, manifest tracking, and
+`[[wikilink]]` connectivity on their own.
+
+For the full routing table (all 15+ skills), see `AGENTS.md` at the repo root.

obsidian_wiki-2026.5.2/.cursor/rules/obsidian-wiki.mdc

@@ -0,0 +1,41 @@
+---
+description: Obsidian Wiki skill-based framework for building and maintaining knowledge bases. Use these rules whenever engaging with the vault, wiki, ingestion, or knowledge management.
+globs: "**/*"
+alwaysApply: true
+---
+
+# Obsidian Wiki — Agent Context
+
+This project is a **skill-based framework** for building and maintaining an Obsidian knowledge base.
+
+## Quick Orientation
+
+1. Read `.env` for `OBSIDIAN_VAULT_PATH` — this is where the wiki lives.
+2. Read `.manifest.json` at the vault root to see what's already been ingested.
+3. Skills are in `.skills/` (also at `.cursor/skills/`). Each subfolder has a `SKILL.md`.
+
+## When to Use Skills
+
+| User says something like… | Read this skill |
+|---|---|
+| "set up my wiki" / "initialize" | `.skills/wiki-setup/SKILL.md` |
+| "ingest" / "add this to the wiki" | `.skills/wiki-ingest/SKILL.md` |
+| "/wiki-history-ingest claude" / "/wiki-history-ingest codex" | `.skills/wiki-history-ingest/SKILL.md` |
+| "import my Claude history" | `.skills/claude-history-ingest/SKILL.md` |
+| "import my Codex history" | `.skills/codex-history-ingest/SKILL.md` |
+| "process this export" / "ingest this data" | `.skills/data-ingest/SKILL.md` |
+| "what's the status" / "show the delta" | `.skills/wiki-status/SKILL.md` |
+| "what do I know about X" / any question | `.skills/wiki-query/SKILL.md` |
+| "audit" / "lint" / "find broken links" | `.skills/wiki-lint/SKILL.md` |
+| "rebuild" / "start over" / "archive" | `.skills/wiki-rebuild/SKILL.md` |
+| "link my pages" / "cross-reference" | `.skills/cross-linker/SKILL.md` |
+| "fix my tags" / "normalize tags" | `.skills/tag-taxonomy/SKILL.md` |
+| "create a new skill" | `.skills/skill-creator/SKILL.md` |
+
+## Key Rules
+
+- **Compile, don't retrieve.** Update existing pages, don't just append.
+- **Always update `.manifest.json`** after ingesting.
+- **Always update `index.md` and `log.md`** after any operation.
+- **Use `[[wikilinks]]`** to connect related pages.
+- **Frontmatter is required** on every wiki page.

obsidian_wiki-2026.5.2/.env.example

@@ -0,0 +1,76 @@
+# =============================================================================
+# Obsidian Wiki — Environment Configuration
+# Copy this to .env and set your vault path
+# =============================================================================
+
+# --- Required ---
+
+# Absolute path to your Obsidian vault
+OBSIDIAN_VAULT_PATH=
+
+# --- Optional ---
+
+# Comma-separated source directories to ingest documents from
+# Leave empty to skip document ingestion
+OBSIDIAN_SOURCES_DIR=
+
+# Wiki categories (directories created in the vault)
+OBSIDIAN_CATEGORIES=concepts,entities,skills,references,synthesis,journal
+
+# Max pages to create/update per ingest operation
+OBSIDIAN_MAX_PAGES_PER_INGEST=15
+
+# Claude conversation history path (auto-discovered from ~/.claude if empty)
+CLAUDE_HISTORY_PATH=
+
+# Codex history path (defaults to ~/.codex if empty)
+CODEX_HISTORY_PATH=
+
+# Pi agent session history path (defaults to ~/.pi/agent/sessions if empty)
+PI_HISTORY_PATH=
+
+# Lint schedule: daily | weekly | manual
+LINT_SCHEDULE=weekly
+
+# Internal link format for generated/updated pages
+# wikilink (default) → [[concepts/foo]] or [[concepts/foo|display text]]
+# markdown           → [display text](relative/path.md)
+# Only affects future writes — existing vault content is never migrated automatically.
+OBSIDIAN_LINK_FORMAT=wikilink
+
+# --- QMD Semantic Search (optional) ---
+#
+# QMD indexes your wiki and sources for fast semantic search.
+# Install: https://github.com/tobi/qmd
+# After installing, point these at your QMD collection names (set when you ran `qmd index`).
+#
+# Without QMD: wiki-ingest and wiki-query fall back to Grep/Glob — fully functional, just slower.
+# With QMD: semantic search replaces grep passes, enabling concept-level matches and cross-collection queries.
+
+# Name of the QMD collection indexing your compiled wiki pages (OBSIDIAN_VAULT_PATH)
+QMD_WIKI_COLLECTION=
+
+# Name of the QMD collection indexing your raw source documents (OBSIDIAN_SOURCES_DIR or _raw/)
+QMD_PAPERS_COLLECTION=
+
+# QMD integration transport: mcp | cli
+# mcp preserves the original behavior and uses an agent-configured QMD MCP server.
+# cli runs the local qmd command directly; useful for agents without QMD MCP support.
+QMD_TRANSPORT=mcp
+
+# CLI search quality mode: quality | balanced | fast
+# quality: qmd query with reranking (best relevance, slowest on CPU)
+# balanced: qmd query --no-rerank (good hybrid results, faster)
+# fast: qmd vsearch (semantic only) or qmd search when exact terms matter
+QMD_CLI_SEARCH_MODE=quality
+
+# Optional qmd binary override if qmd is not on PATH.
+QMD_CLI=qmd
+
+# --- Raw Staging Directory (optional) ---
+#
+# A directory inside OBSIDIAN_VAULT_PATH for unprocessed draft pages.
+# Drop rough notes, clipboard pastes, or quick captures here.
+# wiki-ingest will promote them to proper wiki pages when you run it.
+# Promoted files are deleted from _raw/ after processing.
+OBSIDIAN_RAW_DIR=_raw

obsidian_wiki-2026.5.2/.github/copilot-instructions.md

@@ -0,0 +1,44 @@
+# Obsidian Wiki — Copilot Context
+
+This project is a **skill-based framework** for building and maintaining an Obsidian knowledge base using AI coding agents. There are no scripts or dependencies — everything is markdown instructions that the agent executes directly.
+
+## Project Overview
+
+- **Purpose:** Build and maintain an Obsidian wiki using the LLM Wiki pattern (Andrej Karpathy).
+- **Tech Stack:** Markdown only. No code, no dependencies. The AI agent IS the runtime.
+- **Key Config:** `.env` contains `OBSIDIAN_VAULT_PATH` pointing to the vault location.
+- **Skills:** `.skills/` contains skill folders, each with a `SKILL.md` defining a workflow.
+
+## Key Concepts
+
+- The wiki is a **compiled artifact** — knowledge distilled from raw sources into interconnected pages.
+- Every wiki page has YAML frontmatter: `title`, `category`, `tags`, `sources`, `created`, `updated`.
+- Pages are connected with Obsidian `[[wikilinks]]`.
+- A `.manifest.json` in the vault root tracks all ingested sources for delta-based updates.
+- `index.md` and `log.md` must be updated after every operation.
+
+## Skills Reference
+
+| Skill | Folder | Purpose |
+|---|---|---|
+| Setup | `.skills/wiki-setup/` | Initialize vault structure |
+| Ingest | `.skills/wiki-ingest/` | Distill documents into wiki pages |
+| History Router | `.skills/wiki-history-ingest/` | Route `/wiki-history-ingest <claude|codex>` to the right history skill |
+| Claude History | `.skills/claude-history-ingest/` | Mine `~/.claude` conversations |
+| Codex History | `.skills/codex-history-ingest/` | Mine `~/.codex` sessions and rollout logs |
+| Data Ingest | `.skills/data-ingest/` | Process any text data |
+| Status | `.skills/wiki-status/` | Audit ingestion state and delta |
+| Query | `.skills/wiki-query/` | Answer questions from wiki |
+| Lint | `.skills/wiki-lint/` | Find broken links, orphans |
+| Rebuild | `.skills/wiki-rebuild/` | Archive and rebuild |
+| Cross-Linker | `.skills/cross-linker/` | Auto-discover and insert missing wikilinks |
+| Tag Taxonomy | `.skills/tag-taxonomy/` | Enforce consistent tag vocabulary |
+| LLM Wiki | `.skills/llm-wiki/` | Core architecture pattern |
+| Skill Creator | `.skills/skill-creator/` | Create new skills |
+
+## Coding Conventions
+
+- When creating wiki pages, always use YAML frontmatter.
+- Use `[[wikilinks]]` syntax for cross-references — NOT markdown links.
+- Project-specific knowledge goes in `projects/<name>/`. Global knowledge goes in top-level categories.
+- Never modify the `.obsidian/` directory.

obsidian_wiki-2026.5.2/.github/workflows/publish.yml

@@ -0,0 +1,65 @@
+name: publish
+
+# Build and publish obsidian-wiki to PyPI when a version tag is pushed.
+#
+# Setup (one-time): on PyPI, add a Trusted Publisher for this repo with
+# workflow `publish.yml` and environment `pypi`. No API token needed — the
+# `id-token: write` permission below mints a short-lived OIDC credential.
+#
+# Release: bump `version` in pyproject.toml, commit, then
+#   git tag v0.1.0 && git push origin v0.1.0
+
+on:
+  push:
+    tags:
+      - "v*"
+  # Allow a manual build (artifacts only, no publish) for verification.
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Verify wheel bundles the skills
+        run: |
+          python -m pip install --upgrade twine
+          twine check dist/*
+          wheel=$(ls dist/*.whl)
+          echo "Inspecting $wheel"
+          if ! python -m zipfile -l "$wheel" | grep -q "obsidian_wiki/_data/skills/wiki-setup/SKILL.md"; then
+            echo "::error::wheel is missing bundled skills under obsidian_wiki/_data/skills/"
+            exit 1
+          fi
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    # Only publish on a real tag push, not workflow_dispatch.
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    environment: pypi
+    permissions:
+      id-token: write  # required for PyPI Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

obsidian_wiki-2026.5.2/.github/workflows/setup.yml

@@ -0,0 +1,29 @@
+name: setup
+
+# Guards setup.sh against the regression where it rewrites committed
+# relative symlinks with absolute paths (or any other modification to
+# tracked files). See #52 for the original bug.
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  install-leaves-tree-clean:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run setup.sh
+        # stdin closed so the vault-path prompt returns empty rather than hang
+        run: bash setup.sh < /dev/null
+      - name: Working tree must be unchanged
+        run: |
+          if ! git diff --exit-code; then
+            echo "::error::setup.sh modified tracked files. Likely cause: an" \
+                 "in-repo symlink mirror is being written with an absolute" \
+                 "target instead of a relative one. See install_skills() in setup.sh."
+            exit 1
+          fi
+      - name: Re-run is idempotent
+        run: bash setup.sh < /dev/null && git diff --exit-code

obsidian_wiki-2026.5.2/.gitignore

@@ -0,0 +1,13 @@
+.env
+.DS_Store
+*.pyc
+__pycache__/
+
+# Python build artifacts (pyproject.toml / `python -m build`)
+/dist/
+/build/
+*.egg-info/
+
+# Agent skill symlinks (created by setup.sh) — these are just pointers to .skills/
+# We track them so cloners get the symlinks too, but if your git doesn't
+# preserve symlinks, run `bash setup.sh` after cloning.

obsidian_wiki-2026.5.2/.hermes.md

@@ -0,0 +1 @@
+AGENTS.md

obsidian_wiki-2026.5.2/.kiro/steering/obsidian-wiki.md

@@ -0,0 +1,43 @@
+---
+inclusion: always
+---
+
+# Obsidian Wiki — Agent Context
+
+This project is a **skill-based framework** for building and maintaining an Obsidian knowledge base.
+
+## Quick Orientation
+
+1. Read `~/.obsidian-wiki/config` (or `.env` in this repo) for `OBSIDIAN_VAULT_PATH` — this is where the wiki lives.
+2. Read `.manifest.json` at the vault root to see what's already been ingested.
+3. Skills are in `.skills/` (also at `.kiro/skills/`). Each subfolder has a `SKILL.md`.
+
+## When to Use Skills
+
+| User says something like… | Read this skill |
+|---|---|
+| "set up my wiki" / "initialize" | `wiki-setup` |
+| "ingest" / "add this to the wiki" / "process these docs" | `wiki-ingest` |
+| "import my Claude history" / "mine my conversations" | `claude-history-ingest` |
+| "import my Codex history" | `codex-history-ingest` |
+| "import my Hermes history" | `hermes-history-ingest` |
+| "import my OpenClaw history" | `openclaw-history-ingest` |
+| "import my Pi history" | `pi-history-ingest` |
+| "process this export" / "ingest this data" | `data-ingest` |
+| "what's the status" / "show the delta" | `wiki-status` |
+| "what do I know about X" | `wiki-query` |
+| "audit" / "lint" / "find broken links" | `wiki-lint` |
+| "rebuild" / "archive" / "restore" | `wiki-rebuild` |
+| "link my pages" / "cross-reference" | `cross-linker` |
+| "fix my tags" | `tag-taxonomy` |
+| "update wiki" / "sync to wiki" | `wiki-update` |
+| "export wiki" / "export graph" | `wiki-export` |
+
+## Core Rules
+
+- **Compile, don't retrieve** — update existing pages, don't append or duplicate.
+- **Track everything** — update `.manifest.json`, `index.md`, and `log.md` after every operation.
+- **Connect with `[[wikilinks]]`** — every page should link to related pages.
+- **Frontmatter required** — every page needs `title`, `category`, `tags`, `sources`, `created`, `updated`.
+
+For full context, read `AGENTS.md` at the repo root.