Matomeru

Combine and copy your entire codes into one LLM-ready Markdown.

複数のコードをAI向けの一つのMarkdownにまとめる

English | 日本語

Features

• Generate Markdown documentation for your directory structures and file contents
• Automatically format and organize:
  • Directory tree structure
  • Markdown-compatible output
• Support for multiple output formats:
  • Display in editor
  • Copy to clipboard
  • Send to ChatGPT (macOS only)
• Git Diff Integration:
  • Convert changed files (working tree vs HEAD) to Markdown with one click
  • Optional revision range support (e.g., origin/main..HEAD)
  • Direct access from Explorer and SCM context menus
• Customizable directory structure display:
  • Emoji icons for directories and files
  • Configurable indentation
  • Optional file extension display
• Code Compression (Experimental): Attempts to remove comments using Tree-sitter to reduce context length for LLMs. (See Configuration section for details)
• Flexible file exclusion:
  • Configure custom patterns to exclude
  • Use .gitignore .vscodeignore patterns to automatically exclude files (optional)
• Localization support (English/Japanese)
• Estimate size before processing large projects

Installation

1. Install from VSCode Marketplace
2. Or download the .vsix file and install manually:

   code --install-extension matomeru-0.0.12.vsix
   

Usage

1. Right-click on a directory or file in the explorer
2. Select one of the following options:
   • "Matomeru: Output to Editor"
   • "Matomeru: Copy to Clipboard"
   • "Matomeru: Send to ChatGPT" (macOS only)
   • "Matomeru: Copy Git Diff"

Keyboard Shortcuts

You can also use keyboard shortcuts for quick access:

• Ctrl+Alt+C / Cmd+Alt+C (Mac): Copy to Clipboard
• Ctrl+Alt+D / Cmd+Alt+D (Mac): Copy Git Diff
• Ctrl+Alt+E / Cmd+Alt+E (Mac): Output to Editor

These shortcuts can be customized in VS Code's Keyboard Shortcuts editor (Ctrl+K Ctrl+S / Cmd+K Cmd+S on Mac).

Configuration

{
  "matomeru.maxFileSize": 1048576,
  "matomeru.excludePatterns": [
    "node_modules/**",
    ".git/**",
    "dist/**",
    "build/**",
    "coverage/**",
    ".DS_Store",
    "Thumbs.db",
    "*.key",
    "*.env*",
    "package-lock.json"
  ],
  "matomeru.chatGptIntegration": false,
  "matomeru.directoryStructure.directoryIcon": "📁",
  "matomeru.directoryStructure.fileIcon": "📄",
  "matomeru.directoryStructure.indentSize": 2,
  "matomeru.directoryStructure.showFileExtensions": true,
  "matomeru.prefixText": "",
  "matomeru.useGitignore": false,
  "matomeru.useVscodeignore": false,
  "matomeru.enableCompression": false,
  "matomeru.gitDiff.range": ""
}

Git Diff Range: When matomeru.gitDiff.range is set, Matomeru will use that revision range when collecting changed files. Example values:

• Empty string (default): Shows working tree changes compared to HEAD
• "HEAD~3..HEAD": Shows changes in last 3 commits
• "origin/main..HEAD": Shows changes between main branch and current HEAD

Code Compression: When matomeru.enableCompression is set to true, Matomeru attempts to remove comments and unnecessary code using Tree-sitter for the following languages, making the code more compact for LLMs. (If parsing fails, the original code will be used.)

javascript, typescript, tsx, python, css, ruby, 
csharp, c, cpp, go, rust, java, ini, regex

Note on Security: By default, Matomeru automatically excludes sensitive files like secret keys, credentials, certificates, and environment files (*.key, *.pem, *.env, etc.) to prevent accidental inclusion of confidential information in the generated output. Additionally, many common non-source files like lock files, cache directories, build artifacts, and temporary files are excluded by default. These exclusions are part of the default configuration and will apply even if you customize the excludePatterns setting.

Output Example

# Project Overview
This is a sample project.

# Directory Structure
📁 src
  📄 index.ts
  📄 utils.ts
📁 tests
  📄 index.test.ts

# File Contents

## src/index.ts
- Size: 1.2 KB
- Language: TypeScript

```typescript
// ... file content ...

src/utils.ts

...

## Requirements

- VSCode 1.96.0 or later
- For ChatGPT integration:
  - macOS
  - Google Chrome
  - ChatGPT account

## License

MIT License