{"id":32454197,"url":"https://github.com/naseridev/vibemerge","last_synced_at":"2025-10-26T07:54:11.829Z","repository":{"id":319339599,"uuid":"1058945837","full_name":"naseridev/vibemerge","owner":"naseridev","description":"A command-line tool for merging project files into AI-ready prompts","archived":false,"fork":false,"pushed_at":"2025-10-17T17:49:04.000Z","size":20,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-18T19:58:36.009Z","etag":null,"topics":["python","vibe-coding"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/naseridev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-17T19:09:06.000Z","updated_at":"2025-10-17T17:49:07.000Z","dependencies_parsed_at":"2025-10-18T21:13:21.562Z","dependency_job_id":"0695436e-a12c-426a-9268-02a74691d698","html_url":"https://github.com/naseridev/vibemerge","commit_stats":null,"previous_names":["naseridev/vibemerge"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/naseridev/vibemerge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naseridev%2Fvibemerge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naseridev%2Fvibemerge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naseridev%2Fvibemerge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naseridev%2Fvibemerge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/naseridev","download_url":"https://codeload.github.com/naseridev/vibemerge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naseridev%2Fvibemerge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281074178,"owners_count":26439421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-26T02:00:06.575Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","vibe-coding"],"created_at":"2025-10-26T07:54:07.754Z","updated_at":"2025-10-26T07:54:11.824Z","avatar_url":"https://github.com/naseridev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VibeMerge\n\nA high-performance code merging utility for consolidating source files from multiple languages into a single output file. Built for efficiency and scalability.\n\n## Overview\n\nVibeMerge is designed to aggregate codebases efficiently. It supports over 40 programming languages, provides optional compression, and scales with parallel processing capabilities.\n\n## Features\n\n- Multi-language support for 40+ file types\n- Parallel processing with multi-core utilization\n- Optional whitespace compression\n- Intelligent text file detection\n- Pattern-based file filtering\n- Memory-mapped I/O for large files\n- Progress tracking and detailed statistics\n\n## Installation\n\nClone the repository and ensure Python 3.7+ is installed:\n\n```bash\ngit clone https://github.com/naseridev/vibemerge.git\n```\n\n```bash\ncd vmrg\n```\n\n```bash\nchmod +x vmrg.py\n```\n\n## Usage\n\n### Basic Syntax\n\n```bash\n./vmrg.py [OPTIONS] PATH [PATH ...]\n```\n\n### Examples\n\nMerge all files in a directory:\n```bash\n./vmrg.py /path/to/project\n```\n\nMerge specific files:\n```bash\n./vmrg.py file1.py file2.py file3.py\n```\n\nMerge with custom output:\n```bash\n./vmrg.py /path/to/project -o output.txt\n```\n\nEnable compression and parallel processing:\n```bash\n./vmrg.py /path/to/project -cp -o output.txt\n```\n\nUse ignore patterns:\n```bash\n./vmrg.py /path/to/project -i .gitignore -o output.txt\n```\n\nCombine multiple options:\n```bash\n./vmrg.py /path/to/project -cdpo output.txt -i .gitignore\n```\n\n## Options\n\n| Option | Description |\n|--------|-------------|\n| `-o, --output` | Specify output file path (default: vibemerged.txt) |\n| `-i, --ignore` | Path to ignore patterns file |\n| `-c, --compress` | Enable whitespace compression |\n| `-d, --dont-comment` | Add AI directive to prevent code commenting |\n| `-p, --parallel` | Enable parallel processing for faster merging |\n| `-q, --quiet` | Suppress progress output |\n| `-v, --version` | Display version information |\n\n## Supported Languages\n\nPython, JavaScript, TypeScript, Java, C, C++, C#, Go, Rust, PHP, Ruby, Swift, Kotlin, Scala, Lua, Perl, R, Objective-C, SQL, Shell, Bash, Vim, Dart, Elixir, Erlang, Clojure, Lisp, Haskell, OCaml, F#, Nim, Crystal, V, Zig\n\n## Ignore Patterns\n\nCreate a file with patterns to exclude specific files or directories:\n\n```\nnode_modules\n*.log\nbuild/\ndist/\n.git\n__pycache__\n```\n\n## Performance Considerations\n\n- Parallel processing activates automatically for 4+ files on multi-core systems\n- Maximum file size: 10 MB per file\n- Maximum total size: 1 GB\n- Memory-mapped I/O used for files larger than 256 KB\n\n## Output Format\n\nEach merged file includes a header with the relative path:\n\n```\n--------------------------------------------------------------------------------\nFILE: src/main.py\n--------------------------------------------------------------------------------\n\n[file content]\n```\n\n## Compression Mode\n\nWhen compression is enabled, the output includes a directive for AI systems:\n\n```\n================================================================================\nSYSTEM INSTRUCTION FOR AI\nThis code has been compressed to reduce token usage.\nWhen generating responses or code:\n- Write code in normal, readable format with proper spacing\n- Use standard indentation and line breaks\n- Follow conventional formatting practices\n- DO NOT compress or minify your output\n================================================================================\n```\n\n## Exit Codes\n\n- 0: Success\n- 1: Fatal error\n- 130: User interruption\n\n## Requirements\n\n- Python 3.7 or higher\n- No external dependencies required\n\n## Contributing\n\nContributions are welcome. Submit pull requests with clear descriptions and test coverage.\n\n## Support\n\nFor issues or questions, open an issue on the GitHub repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaseridev%2Fvibemerge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnaseridev%2Fvibemerge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaseridev%2Fvibemerge/lists"}