project-tree

Project Tree

Overview

Generate a visual tree structure of the ~/projects directory and automatically update MEMORY.md with the current project organization. The tree shows folders and .md files only, with smart grouping for consecutive numbered items.

Usage

Run the tree generation script:

node ~/clawd/skills/project-tree/scripts/project-tree.js

Or use the convenience wrapper:

~/clawd/scripts/update-tree

Features

• Folder-only + .md files: Only displays directories and markdown files, hiding code files and dependencies
• Smart grouping: Detects consecutive numbered sequences (e.g., script1-video, script2-video...) and collapses them into script[1-28]-video/ (28 items)
• Auto-updates MEMORY.md: The tree is automatically inserted into the PROJECT_TREE section of MEMORY.md
• Configurable depth: Default is 3 levels deep (adjustable in script)

Configuration

Edit these values in scripts/project-tree.js:

• MAX_DEPTH: Number of directory levels to display (default: 3)
• EXCLUDE_DIRS: Directories to skip (node_modules, .git, etc.)
• ROOT_DIR: Base directory to scan (default: ~/projects)

Automation (Hook)

You can automate project tree updates to run on every session /reset.

1. Enable Internal Hooks

Add to your clawdbot.json:

{
  "hooks": {
    "internal": {
      "enabled": true
    }
  }
}

2. Create the Hook

Create ~/.clawdbot/hooks/reset-project-tree/HOOK.md:

---
name: reset-project-tree
description: "Generate project tree on session reset"
metadata: {"clawdbot":{"emoji":"?","events":["command:reset"],"requires":{"bins":["node"]}}}
---

Generates project tree when /reset is issued.

Create ~/.clawdbot/hooks/reset-project-tree/handler.ts:

import { execSync } from 'child_process';
import type { HookHandler } from '../../../src/hooks/hooks.js';

const handler: HookHandler = async (event) => {
  if (event.type !== 'command' || event.action !== 'reset') return;

  try {
    const scriptPath = `${event.context.workspaceDir}/skills/project-tree/scripts/project-tree.js`;
    execSync(`node ${scriptPath}`, { cwd: event.context.workspaceDir, stdio: 'pipe' });
    console.log('[reset-project-tree] Updated');
  } catch (err) {
    console.error('[reset-project-tree] Failed:', err instanceof Error ? err.message : String(err));
  }
};

export default handler;

3. Enable and Restart

clawdbot hooks enable reset-project-tree
clawdbot gateway restart

Resources

scripts/

• project-tree.js - Main tree generation script with smart grouping logic