{"id":30351211,"url":"https://github.com/melchizedek6809/planetarium","last_synced_at":"2026-05-19T10:05:25.392Z","repository":{"id":306997644,"uuid":"1028014595","full_name":"Melchizedek6809/planetarium","owner":"Melchizedek6809","description":"VSCode extension for visualizing a codebase as a graph view - meant for keeping an overview while vibecoding","archived":false,"fork":false,"pushed_at":"2025-08-02T13:41:14.000Z","size":87,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-17T23:41:37.780Z","etag":null,"topics":["typescript","vibe-coding","vscode-extension"],"latest_commit_sha":null,"homepage":"https://cocz.net/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Melchizedek6809.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2025-07-28T22:27:20.000Z","updated_at":"2025-08-02T13:41:18.000Z","dependencies_parsed_at":"2025-07-28T22:48:31.480Z","dependency_job_id":"1dd327e9-218d-4d50-8885-b25075ec0495","html_url":"https://github.com/Melchizedek6809/planetarium","commit_stats":null,"previous_names":["melchizedek6809/planetarium"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Melchizedek6809/planetarium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Melchizedek6809%2Fplanetarium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Melchizedek6809%2Fplanetarium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Melchizedek6809%2Fplanetarium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Melchizedek6809%2Fplanetarium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Melchizedek6809","download_url":"https://codeload.github.com/Melchizedek6809/planetarium/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Melchizedek6809%2Fplanetarium/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271073387,"owners_count":24694538,"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-08-18T02:00:08.743Z","response_time":89,"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":["typescript","vibe-coding","vscode-extension"],"created_at":"2025-08-18T23:01:36.512Z","updated_at":"2026-05-19T10:05:25.364Z","avatar_url":"https://github.com/Melchizedek6809.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Planetarium 🪐\n\n**Step back and see your project from far away**\n\nPlanetarium is a VS Code extension that provides a live, interactive graph visualization of your codebase architecture. It shows the relationships between files and dependencies in a Google Maps-style interface that helps you maintain a bird's-eye view of your project structure.\n\n**Free and Open Source** - Licensed under MIT License\n\n## Overview\n\nWhen working with AI coding agents, it's crucial to understand how code changes affect the overall architecture. Planetarium visualizes your codebase as an interactive graph where:\n\n- **Files are nodes** showing their name, file type icon, and lines of code metrics\n- **Connections show dependencies** between modules through import relationships\n- **Git change tracking** highlights added/removed/modified files and dependencies with color coding\n- **Interactive navigation** with Google Maps-style controls (left-click to pan, scroll to zoom)\n- **Jump to definition** by clicking on nodes to open files in VS Code\n\n## Features\n\n### ✅ Live Architecture Visualization\n- Real-time D3.js force-directed graph of your entire codebase structure\n- Each file represented as a node with file type emoji icon and LOC metrics\n- Visual connections (edges) showing import/dependency relationships between files\n- Cumulative LOC display showing file size plus all direct dependencies\n\n### ✅ Git Change Tracking\n- **Color-coded nodes**: Green for added files, red for removed files, yellow for modified files\n- **Color-coded edges**: Green arrows for new dependencies, red dashed arrows for removed dependencies\n- **Color-coded arrow heads**: Match the git status of the dependency relationship\n- Perfect for reviewing how AI agents have modified your architecture\n- Real-time working tree status integration using VS Code's git API\n\n### ✅ Interactive Navigation  \n- Google Maps-style interface (pan with left-click, zoom with mouse wheel)\n- Click on any node to jump directly to the file in VS Code\n- Intuitive exploration of large codebases with pan/zoom controls\n- Node opacity based on outgoing dependency count for visual hierarchy\n\n### ✅ Comprehensive Language Support\n- **50+ supported file types** via Language Server Protocol (LSP)\n- **JavaScript/TypeScript**: Full ES6/CommonJS import support including type imports\n- **Web Technologies**: CSS, SCSS, Sass, Less, HTML with @import and link detection\n- **Programming Languages**: Python, Java, C++, Go, Rust, PHP, Ruby, Swift, and many more\n- **Smart Import Detection**: Mixed imports, destructuring, type-only imports, bare imports\n\n### ✅ Advanced Import Analysis\n- Comprehensive regex pattern matching for all import syntaxes\n- Support for `import`, `require`, `@import`, destructuring, type imports\n- Relative path resolution with automatic file extension detection\n- CSS import detection from JavaScript/TypeScript files\n\n## Use Cases\n\n- **AI-Assisted Development**: Monitor how coding agents affect your project's architecture in real-time\n- **Code Review**: Quickly understand the scope and impact of changes with git-aware visualization\n- **Architecture Planning**: Visualize dependencies to maintain modularity and identify coupling\n- **Onboarding**: Help new team members understand codebase structure through interactive exploration\n- **Refactoring**: Identify tightly coupled components and visualize architectural improvements\n- **Multi-Language Projects**: Understand dependencies across JavaScript, TypeScript, CSS, and other languages\n\n## Current Status\n\n✅ **Fully Functional** - The extension is complete with all core features implemented:\n- Multi-language LSP integration (50+ file types)\n- Git-aware visualization with real-time change tracking\n- Comprehensive import/dependency analysis  \n- Interactive D3.js graph with navigation controls\n- Advanced pattern matching for all import syntaxes\n\n## Usage\n\n1. Install the extension in VS Code\n2. Open any workspace with code files\n3. Run command: `Planetarium: Open View` (Ctrl+Shift+P)\n4. Interact with the graph:\n   - **Pan**: Left-click and drag\n   - **Zoom**: Mouse wheel\n   - **Navigate**: Click nodes to open files\n   - **View Dependencies**: Follow arrows to see import relationships\n   - **Git Status**: Colors show added (green), removed (red), modified (yellow) files\n\n## Requirements\n\n- VS Code 1.102.0 or higher\n- Any supported language project (JavaScript, TypeScript, Python, Java, C++, Go, Rust, CSS, etc.)\n- Git repository (optional, for change tracking features)\n\n## Installation\n\nCurrently in development. Will be available on the VS Code Marketplace once ready.\n\n## License\n\nMIT License - Free and open source software\n\n## Contributing\n\nThis project is complete and functional. Contributions and feedback are welcome for future enhancements!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelchizedek6809%2Fplanetarium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmelchizedek6809%2Fplanetarium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelchizedek6809%2Fplanetarium/lists"}