Copy Project Tree

Copy clean project and folder tree structures from VS Code to your clipboard or to a file.

Features

Copy a workspace tree or any selected folder from the Explorer.
Save output as .txt, .md, or .json.
Generate stable output with predictable sorting.
Exclude common dependency, build, cache, and IDE folders by default.
Respect the selected project's root .gitignore file by default.
Add custom exact-name exclusions or gitignore-style patterns, including negations.
Choose whether to include hidden entries, files, and the selected root folder.
Scan asynchronously with visible progress and cancellation for large projects.
Work with local, remote, and supported virtual workspace filesystems through desktop VS Code.
Protect VS Code from unexpectedly large output with a configurable entry limit.

Open a project in VS Code.
Right-click empty space in the Explorer and choose Copy Project Tree Structure.
Right-click a folder in the Explorer and choose Copy Folder Tree Structure.
Adjust output behavior in VS Code Settings under Copy Project Tree.

Large trees show a cancellable progress notification. The one-click workflow remains the same.

Plain text:

├── src/
│   ├── commands.ts
│   └── treeGenerator.ts
├── package.json
└── README.md

Markdown:

- src/
  - commands.ts
  - treeGenerator.ts
- package.json
- README.md

JSON:

{
  "name": "copy-project-tree",
  "path": "",
  "type": "directory",
  "children": []
}

Setting	Type	Default	Description
`copyProjectTree.useDefaultExclusions`	`boolean`	`true`	Exclude common dependency, build, cache, and IDE entries. Disable this to use only custom exclusions and `.gitignore`.
`copyProjectTree.excludedFolders`	`string[]`	`[]`	Additional file or folder names to exclude. Built-in exclusions already cover common dependency, build, cache, and IDE folders.
`copyProjectTree.excludedPatterns`	`string[]`	`[]`	Additional gitignore-style patterns such as `docs/`, `*/.log`, or `!important.log`.
`copyProjectTree.respectGitignore`	`boolean`	`true`	Apply rules from the selected project's root `.gitignore` file.
`copyProjectTree.maxDepth`	`number`	`-1`	Maximum depth. Use `-1` for no limit.
`copyProjectTree.maxEntries`	`number`	`100000`	Maximum included files and folders. Use `-1` for no limit.
`copyProjectTree.includeHidden`	`boolean`	`false`	Include hidden files and folders.
`copyProjectTree.includeFiles`	`boolean`	`true`	Include files. Disable this for a folders-only tree.
`copyProjectTree.includeRoot`	`boolean`	`false`	Include the selected project or folder name as the first line in plain text and Markdown output.
`copyProjectTree.sortOrder`	`string`	`foldersFirst`	Use `foldersFirst` or `alphabetical`.
`copyProjectTree.outputFormat`	`string`	`plain`	Use `plain`, `markdown`, or `json`.
`copyProjectTree.copyToFile`	`boolean`	`false`	Save the tree to a file instead of copying it to the clipboard.

npm ci
npm test
npm run package

Release notes and publishing steps live in RELEASE.md.