tree-reader

/tree-reader — Read-Only Knowledge Tree Viewer

Portable read-only viewer for a knowledge tree. Uses ONLY built-in tools (Read, Grep, Glob) — no Python, no scripts, no external dependencies.

Setup

In a Mind-framework project (with local-paths.conf): works automatically.

Standalone (shared with another agent):

1. Copy this directory to .claude/skills/tree-reader/
2. Uncomment and set the TREE_DIR line in Step 0 below
3. Done. Use any sub-command.

Sub-Commands

/tree-reader read <key>      — Read node metadata + .md content
/tree-reader find <query>    — Search nodes by keyword
/tree-reader stats           — Tree health overview
/tree-reader browse [key]    — List children (root if no key)
/tree-reader path <key>      — Show ancestry chain to root

Step 0: Resolve TREE_DIR

Run this before every sub-command to set TREE_DIR.

Standalone mode — uncomment ONE line and set your path:

# TREE_DIR = "C:/Users/Shared/my-world/knowledge/tree"
# TREE_DIR = "/mnt/sharepoint/knowledge/tree"

Dynamic mode (default) — resolve from project config:

1. Read: {MIND_AGENT}/local-paths.conf
   (if MIND_AGENT not set: Glob for */local-paths.conf → use first match)
2. Extract the value after "WORLD_PATH=" on the matching line
3. TREE_DIR = {WORLD_PATH}/knowledge/tree

File Path Resolution

Node file: values in _tree.yaml use the virtual prefix world/knowledge/tree/. To get the real path, replace that prefix with {TREE_DIR}/.

Example: file: "world/knowledge/tree/intelligence/core-engine.md" becomes {TREE_DIR}/intelligence/core-engine.md.

_tree.yaml Structure

The index file has a header (last_updated, tree_growth_log, etc.) followed by a nodes: section. All nodes are in a flat dictionary at 2-space indent under nodes:, regardless of tree depth. Properties are at 4-space indent.

nodes:
  node-key:                          # ← 2-space indent (the key to grep for)
    file: world/knowledge/tree/...   # ← 4-space indent (properties)
    depth: 3
    parent: parent-key
    children: [child-a, child-b]     # may span multiple lines
    child_count: 2
    summary: Brief description...
    confidence: 0.85
    capability_level: EXPLOIT        # EXPLORE | CALIBRATE | EXPLOIT
    growth_state: stable