whatisgithub

What is filetree-skill?

nekocode/filetree-skill — explained in plain English

Analysis updated 2026-05-18

125PythonAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code plugin that maintains a one-line-per-file project manifest so the AI skips rediscovering the codebase each session.

Mindmap

mindmap
  root((filetree-skill))
    What it does
      Generates FILETREE.md manifest
      Tracks changed files via git
      Lints manifest drift in CI
    Tech stack
      Python
      Claude Code plugin
      Git
    Use cases
      Speed up AI session startup
      Keep project overview current
      Enforce manifest freshness in CI
    Audience
      Developers using Claude Code
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a FILETREE.md manifest so Claude Code understands a codebase instantly at session start.

USE CASE 2

Keep the manifest in sync automatically as files are added, removed, or changed.

USE CASE 3

Check for manifest drift in CI so the project overview never goes stale.

What is it built with?

PythonClaude CodeGit

How does it compare?

nekocode/filetree-skilldannymac180/skillszhengdian1/interleavethinker
Stars125124124
LanguagePythonPythonPython
Setup difficultyeasyeasyhard
Complexity2/52/55/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Python 3.9+ and git, installed via Claude Code's plugin marketplace.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

filetree is a plugin for Claude Code (Anthropic's AI coding assistant) that solves a specific and repeatable problem: every time you start a new Claude Code session on a codebase, the AI has to rediscover the project layout from scratch by scanning directories and reading files. That discovery work costs tokens and takes time, and it cannot be reused between sessions. The plugin's answer is a file called FILETREE.md, checked into the repository alongside the code. It contains one line per file in the project, with a plain-English description of what that file does and a short hash of the file's contents. When Claude Code reads FILETREE.md at the start of a session, it gets an instant overview of the whole project in a few hundred tokens, rather than spending dozens of tool calls on ls, grep, and file reads. Three commands drive the workflow. The init command generates FILETREE.md from scratch by scanning the repo and asking the AI to write a one-line summary for each file. The update command syncs the manifest after code changes: it uses git to detect added, removed, renamed, and changed files, then asks the AI only about the ones that actually changed. Files that were modified but whose purpose stayed the same get marked UNCHANGED, which means only the hash is refreshed, not the description. The lint command checks whether the manifest is out of date without making any changes, and exits with an error code if it finds drift, making it usable in CI. The plugin requires Python 3.9 or newer and has no third-party dependencies beyond git. It is installed through Claude Code's plugin marketplace with a single command. The README notes it will not run background processes, build a search index, or auto-commit anything. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Show me how to install filetree-skill and generate FILETREE.md for my repo.
Prompt 2
Explain how the update command decides which files need new descriptions.
Prompt 3
Help me add the lint command to my CI pipeline to catch manifest drift.
Prompt 4
Walk me through what gets marked UNCHANGED versus re-described after a code edit.

Frequently asked questions

What is filetree-skill?

A Claude Code plugin that maintains a one-line-per-file project manifest so the AI skips rediscovering the codebase each session.

What language is filetree-skill written in?

Mainly Python. The stack also includes Python, Claude Code, Git.

What license does filetree-skill use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is filetree-skill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is filetree-skill for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.