Project Tree Generator for Openclaw

Automatically generate and maintain a visual directory tree of your projects folder while syncing the output to your central memory file.

lachlanglasgow
v1.0.3
Jan 29, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install project-tree

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install project-tree using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Project Tree Generator?

The project-tree skill is a specialized utility designed to keep your workspace organized and context-aware. It scans your projects directory to create a clean, visual representation of your folder hierarchy, specifically filtering for directories and markdown files. This makes it an essential tool for developers and users of Openclaw Skills who need to maintain a high-level overview of their files without the clutter of source code or dependency folders.

Beyond simple visualization, this skill integrates directly with your MEMORY.md file. By automatically updating a designated PROJECT_TREE section, it ensures that your AI agents always have access to the latest state of your file system, facilitating better project management and context retrieval.

Project Tree Generator Use Cases

  • Maintaining a clear visual map of complex project directories for better navigation.
  • Keeping an AI agent updated with the current project structure via MEMORY.md.
  • Organizing large numbers of similar assets through smart grouping of numbered files.
  • Cleaning up workspace context by hiding node_modules and other irrelevant build artifacts.

How Project Tree Generator Works

  1. The script initiates a scan starting from the defined ROOT_DIR, typically the ~/projects folder.
  2. It traverses the directory tree up to a configurable depth, filtering for folders and markdown files.
  3. A smart grouping logic identifies consecutive numbered items and collapses them into a single entry to reduce visual noise.
  4. The generated tree structure is then formatted and injected into the MEMORY.md file, replacing the existing PROJECT_TREE section.
  5. The process can be triggered manually or automated through session-based hooks.

Project Tree Generator Setup

To install the skill, ensure you have Node.js installed and execute the generation script directly:

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

For faster access, you can use the provided convenience wrapper script:

~/clawd/scripts/update-tree

Configuration values such as MAX_DEPTH and EXCLUDE_DIRS can be modified within the project-tree.js file to suit your specific environment for your Openclaw Skills setup.

Project Tree Generator Data Schema & Taxonomy

The skill interacts with and organizes data using the following schema:

Attribute Description
ROOT_DIR The starting path for the directory scan (default: ~/projects).
MEMORY.md The target file where the PROJECT_TREE section is updated.
smart grouping Logic that collapses patterns like file1, file2 into file[1-x].
EXCLUDE_DIRS A list of directories ignored during the scan, such as .git and node_modules.

Project Tree Generator Advanced Features

  • Automated updates on every session reset using the internal Openclaw Skills hooks system.
  • Customizable directory depth limiting to manage tree complexity.
  • Smart collapse logic for sequences of numbered folders or files to keep the tree concise.
  • Seamless integration with the MEMORY.md file for persistent agent memory.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*