{"id":50615483,"url":"https://github.com/minhkhoixyz/xyz-project-mapper","last_synced_at":"2026-06-06T08:00:57.077Z","repository":{"id":348042484,"uuid":"1196219274","full_name":"MinhKhoixyz/xyz-project-mapper","owner":"MinhKhoixyz","description":"A lightweight web utility to map project structures","archived":false,"fork":false,"pushed_at":"2026-03-30T14:19:23.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-30T16:27:12.328Z","etag":null,"topics":["ai-tools","chatgpt","claude","developer-tools","llm-context","prompt-engineering","vue3"],"latest_commit_sha":null,"homepage":"https://minhkhoixyz.github.io/xyz-project-mapper/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MinhKhoixyz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2026-03-30T13:41:14.000Z","updated_at":"2026-03-30T14:20:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/MinhKhoixyz/xyz-project-mapper","commit_stats":null,"previous_names":["minhkhoixyz/xyz-project-mapper"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/MinhKhoixyz/xyz-project-mapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhKhoixyz%2Fxyz-project-mapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhKhoixyz%2Fxyz-project-mapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhKhoixyz%2Fxyz-project-mapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhKhoixyz%2Fxyz-project-mapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MinhKhoixyz","download_url":"https://codeload.github.com/MinhKhoixyz/xyz-project-mapper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhKhoixyz%2Fxyz-project-mapper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33973868,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"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":["ai-tools","chatgpt","claude","developer-tools","llm-context","prompt-engineering","vue3"],"created_at":"2026-06-06T08:00:52.091Z","updated_at":"2026-06-06T08:00:57.065Z","avatar_url":"https://github.com/MinhKhoixyz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eXYZ Project Mapper 🗺️\u003c/h1\u003e\n  \u003cp\u003e\u003cb\u003eThe ultimate context-packing tool for AI Assistants (ChatGPT, Claude, Gemini)\u003c/b\u003e\u003c/p\u003e\n  \n  [![Deploy Status](https://github.com/MinhKhoixyz/xyz-project-mapper/actions/workflows/deploy.yml/badge.svg)](https://github.com/MinhKhoixyz/xyz-project-mapper/actions)\n\u003c/div\u003e\n\n## 🚀 Live Demo\n\n**[Try XYZ Project Mapper Now](https://minhkhoixyz.github.io/xyz-project-mapper/)**\n\n---\n\n## 💡 The Problem\n\nProviding context to Large Language Models (LLMs) can be painful. You can't just drag and drop a whole project folder. Copy-pasting individual files loses the crucial directory structure, leaving the AI confused about how your project pieces fit together. Furthermore, with the rise of AI Agents, managing exactly what an AI *should* and *should not* see is crucial for preventing hallucinations, ensuring security, and saving tokens.\n\n## ✨ The Solution\n\n**XYZ Project Mapper** is a lightweight web utility that solves this context management problem. It reads your local project directory, generates a beautiful ASCII directory tree, allows you to selectively pick important code files, and bundles everything into a single `.txt` file perfectly formatted for AI consumption.\n\n### 🔥 Key Features\n\n- 🔒 **Privacy First (Zero Backend):** Uses the modern `File System Access API`. Your code never leaves your machine. It's processed 100% locally in your browser.\n- 🌳 **Smart ASCII Tree:** Automatically generates a visual structure of your project, intelligently sorting directories above files (IDE-style) while skipping heavy folders like `node_modules` or `.git`.\n- 🎯 **Selective \u0026 Bulk Export:** Don't bloat your prompt! Check only the files you want the AI to analyze. Use the quick action button on any folder to instantly select or deselect all its contents.\n- 💅 **Premium IDE-like UI:** A beautifully spacious, dark-mode interface featuring a smooth animated mesh gradient background, resizable sidebar, custom scrollbars, and intuitive Lucide icons to ensure a top-tier developer experience.\n\n## 🛠️ Tech Stack\n\n- **Frontend:** Vue.js 3 (CDN), HTML5, Vanilla CSS3 (Modern Flexbox/Grid)\n- **Icons:** [Lucide Icons](https://lucide.dev/)\n- **Core API:** `window.showDirectoryPicker()`\n- **CI/CD:** GitHub Actions \u0026 GitHub Pages\n\n## 💻 Local Development\n\nThis project is pure frontend with no complex build steps required. To run or modify the code locally:\n\n1. **Clone this repository:**\n   ```bash\n   git clone https://github.com/MinhKhoixyz/xyz-project-mapper.git\n   ```\n\n2. **Run a local server:**\n   Because it uses the `File System Access API`, it must be served over `localhost`, `127.0.0.1`, or HTTPS. You can use any static server, such as VS Code's Live Server, Python, or npx:\n   ```bash\n   npx serve .\n   # or\n   python -m http.server\n   ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminhkhoixyz%2Fxyz-project-mapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminhkhoixyz%2Fxyz-project-mapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminhkhoixyz%2Fxyz-project-mapper/lists"}