{"id":21221029,"url":"https://github.com/mollybeach/codebase-snapshot-ai-lens","last_synced_at":"2025-03-15T01:12:12.468Z","repository":{"id":262697601,"uuid":"887987164","full_name":"mollybeach/codebase-snapshot-ai-lens","owner":"mollybeach","description":"A Node.js utility for generating comprehensive project documentation snapshots 📸  including folder tree structures 📁 🌳 optimized for AI assistance. This tool analyzes repository content, creates file listings, and generates detailed project snapshots while respecting common gitignore patterns.🔍","archived":false,"fork":false,"pushed_at":"2024-11-14T20:02:35.000Z","size":36,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-21T17:09:01.569Z","etag":null,"topics":["ai","ai-visualization","codebase","filesystem","javascript","mjs"],"latest_commit_sha":null,"homepage":"","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/mollybeach.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}},"created_at":"2024-11-13T16:10:36.000Z","updated_at":"2024-11-16T05:35:07.000Z","dependencies_parsed_at":"2024-11-14T21:18:06.402Z","dependency_job_id":null,"html_url":"https://github.com/mollybeach/codebase-snapshot-ai-lens","commit_stats":null,"previous_names":["mollybeach/repositorycontentprinter","mollybeach/codebase-snapshot-ai-lens"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mollybeach%2Fcodebase-snapshot-ai-lens","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mollybeach%2Fcodebase-snapshot-ai-lens/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mollybeach%2Fcodebase-snapshot-ai-lens/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mollybeach%2Fcodebase-snapshot-ai-lens/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mollybeach","download_url":"https://codeload.github.com/mollybeach/codebase-snapshot-ai-lens/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243668235,"owners_count":20328042,"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","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","ai-visualization","codebase","filesystem","javascript","mjs"],"created_at":"2024-11-20T22:15:22.920Z","updated_at":"2025-03-15T01:12:12.433Z","avatar_url":"https://github.com/mollybeach.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Codebase Snapshot AI Lens\n\nA Node.js utility for generating comprehensive project documentation snapshots optimized for AI assistance. This tool analyzes repository content, creates file listings, and generates detailed project snapshots while respecting common gitignore patterns.\n\n## Description\nThis project provides a powerful tool for developers to generate detailed documentation snapshots of their repositories, specifically designed to share codebase context with AI assistants. It recursively analyzes project structures, creates file listings, and generates comprehensive project snapshots while respecting common gitignore patterns and maintaining configurable limits. The generated snapshots are formatted to provide AI models with clear, structured insights into your codebase.\n\n## Features\n\n### Content Analysis\n- 📄 Creates a consolidated file containing all project content\n- 📊 Enforces a 2000-line limit on output\n- 🚫 Skips binary files and common development artifacts\n- ✨ Provides real-time processing feedback\n\n### Directory Structure\n- 🌳 Generates visual directory structure trees\n- 📁 Shows hierarchical file organization\n- 🔍 Supports custom ignore patterns\n- 🎯 Creates clean, formatted output\n\n### Project Documentation\n- 📸 Creates comprehensive project snapshots\n- 📝 Extracts project documentation from README\n- 🛠️ Lists project dependencies and technologies\n- 🔄 Combines tree structure and content into one view\n\n## Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/mollybeach/project-snapshot-printer.git\ncd project-snapshot-printer\n```\n\n## Usage\n\nGenerate a complete project snapshot:\n```bash\nnode repo-scanners/projectSnapshotPrinter.mjs\n```\n\n## Configuration\n\nModify `config.mjs` to customize:\n- Project root path\n- Output file locations\n- Ignore patterns\n- Line limits\n\n## Output Files\n\nThe tool generates three main output files in the `output` directory:\n- `contentPrinted.txt`: Full content of all processed files\n- `treePrinted.txt`: Visual directory structure\n- `projectSnapshotPrinted.txt`: Combined project snapshot\n\n## Contributing\n\nFeel free to submit issues and enhancement requests!\n\n## License\n\nMIT\n\n## Author\n\n@mollybeach\n\n## Project Structure\n\n```\n./project-snapshot-printer/\n├── .git/\n├── output/\n│   ├── contentPrinted.txt\n│   ├── projectSnapshotPrinted.txt\n│   └── treePrinted.txt\n├── repo-scanners/\n│   ├── contentPrinter.mjs\n│   ├── projectSnapshotPrinter.mjs\n│   └── treePrinter.mjs\n├── .DS_Store\n├── config.mjs\n└── README.md\n\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmollybeach%2Fcodebase-snapshot-ai-lens","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmollybeach%2Fcodebase-snapshot-ai-lens","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmollybeach%2Fcodebase-snapshot-ai-lens/lists"}