devenv-inspector 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DevEnv Inspector Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+<div align="center">
+  <img src="media/logo.png" alt="DevEnv Inspector Logo" width="120" />
+
+  <h1>DevEnv Inspector</h1>
+
+  <p>A unified desktop GUI for inspecting and managing your development runtimes and global packages — no terminal required.</p>
+
+  <p>
+    <img src="https://img.shields.io/badge/version-0.1.0-5a7af5?style=for-the-badge" alt="Version" />
+    <img src="https://img.shields.io/badge/platform-macOS-lightgrey?style=for-the-badge&logo=apple" alt="Platform" />
+    <img src="https://img.shields.io/badge/license-MIT-44c98b?style=for-the-badge" alt="License" />
+    <img src="https://img.shields.io/badge/open%20source-%E2%9D%A4-e05454?style=for-the-badge" alt="Open Source" />
+    <a href="https://www.npmjs.com/package/devenv-inspector-cli">
+      <img src="https://img.shields.io/npm/v/devenv-inspector-cli?style=for-the-badge&logo=npm&color=cc3534" alt="npm CLI" />
+    </a>
+  </p>
+
+  <p>
+    <a href="https://github.com/ali-aldahmani/devenv-inspector/issues">
+      <img src="https://img.shields.io/badge/Report%20a%20Bug-e05454?style=for-the-badge&logo=github&logoColor=white" alt="Report Bug" />
+    </a>
+    <a href="https://github.com/ali-aldahmani/devenv-inspector/issues">
+      <img src="https://img.shields.io/badge/Request%20Feature-5a7af5?style=for-the-badge&logo=github&logoColor=white" alt="Request Feature" />
+    </a>
+    <a href="https://github.com/ali-aldahmani/devenv-inspector/fork">
+      <img src="https://img.shields.io/badge/Fork%20this%20repo-44c98b?style=for-the-badge&logo=github&logoColor=white" alt="Fork" />
+    </a>
+  </p>
+</div>
+
+---
+
+## What is this?
+
+Developers who work across Python, Node.js, and Conda constantly switch between terminal commands just to see what's installed. DevEnv Inspector puts it all in one window — version badges, a searchable package list, and one-click uninstallation.
+
+<div align="center">
+  <img src="media/screenshot.png" alt="DevEnv Inspector Screenshot" width="780" />
+</div>
+
+---
+
+## Features
+
+- **Runtime detection** — instantly shows installed versions of Python, Conda, and Node.js
+- **Unified package table** — all pip, conda, and npm global packages in one searchable list
+- **Safe uninstallation** — confirmation dialog before any package is removed
+- **Filter by manager** — quickly scope the list to pip / conda / npm
+- **Graceful fallbacks** — missing runtimes show "Not Installed" and hide irrelevant packages
+- **No internet required** — everything runs locally against your machine
+
+---
+
+## CLI Companion
+
+Prefer the terminal? The same functionality is available as a standalone npm package — **[devenv-inspector-cli on npm](https://www.npmjs.com/package/devenv-inspector-cli)**:
+
+```bash
+npm install -g devenv-inspector-cli
+```
+
+```bash
+devenv list                        # show all runtimes
+devenv packages                    # list all global packages
+devenv packages --runtime pip      # filter by manager
+devenv uninstall numpy --runtime conda
+devenv info python
+```
+
+> Source lives in [`cli/`](./cli) — same repo, zero Electron. Docker support included.
+
+---
+
+## Built With
+
+<div align="center">
+  <img src="https://skillicons.dev/icons?i=electron,react,vite,nodejs,python,npm,yarn,pnpm,docker,git&theme=dark" />
+</div>
+
+<div align="center">
+
+| Technology | Role |
+|---|---|
+| <img src="https://img.shields.io/badge/Electron-47848f?style=flat-square&logo=electron&logoColor=white" /> | Desktop shell & system command execution |
+| <img src="https://img.shields.io/badge/React-18-61dafb?style=flat-square&logo=react&logoColor=black" /> | Renderer UI & component state |
+| <img src="https://img.shields.io/badge/Vite-646cff?style=flat-square&logo=vite&logoColor=white" /> | Build tooling via electron-vite |
+| <img src="https://img.shields.io/badge/Node.js-339933?style=flat-square&logo=node.js&logoColor=white" /> | Runtime & IPC bridge |
+| <img src="https://img.shields.io/badge/Python-3776ab?style=flat-square&logo=python&logoColor=white" /> | pip package detection & uninstall |
+| <img src="https://img.shields.io/badge/npm-cc3534?style=flat-square&logo=npm&logoColor=white" /> | Global npm package detection |
+| <img src="https://img.shields.io/badge/Yarn-2c8ebb?style=flat-square&logo=yarn&logoColor=white" /> | Global yarn package detection & uninstall |
+| <img src="https://img.shields.io/badge/pnpm-f69220?style=flat-square&logo=pnpm&logoColor=white" /> | Global pnpm package detection & uninstall |
+| <img src="https://img.shields.io/badge/Docker-2496ed?style=flat-square&logo=docker&logoColor=white" /> | Containerized CLI environment |
+| <img src="https://img.shields.io/badge/Git-f05032?style=flat-square&logo=git&logoColor=white" /> | Version control |
+
+</div>
+
+---
+
+## Getting Started
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org) v18 or later
+- npm v9 or later
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/ali-aldahmani/devenv-inspector.git
+
+# Navigate into the project
+cd devenv-inspector
+
+# Install dependencies
+npm install
+
+# Start the app in development mode
+npm run dev
+```
+
+### Package as a macOS app
+
+```bash
+npm run package
+```
+
+This builds the source and produces a `.dmg` installer in `dist/`:
+- `DevEnv Inspector-0.1.0-arm64.dmg` — Apple Silicon
+- `DevEnv Inspector-0.1.0.dmg` — Intel
+
+---
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────┐
+│              Renderer Process               │
+│   React UI — table, filters, dialogs        │
+└──────────────────┬──────────────────────────┘
+                   │  IPC (contextBridge)
+┌──────────────────▼──────────────────────────┐
+│               Main Process                  │
+│  detectors.js  →  python3 / conda / node    │
+│  parsers.js    →  pip / conda / npm --json  │
+│  ipcHandlers.js → uninstall routing         │
+│  shell.js      →  login shell executor      │
+└─────────────────────────────────────────────┘
+```
+
+Every command runs through the user's login shell (`zsh -i -l -c`) so that conda, pyenv, nvm, and other shell-managed tools are always found — both in dev mode and in the packaged `.app`.
+
+---
+
+## Supported Runtimes (v0.1.0)
+
+| Runtime | Packages | Uninstall |
+|---|---|---|
+| Python | `python3 -m pip list` | `python3 -m pip uninstall -y` |
+| Anaconda | `conda list --json` | `conda remove -y` |
+| Node.js | `npm list -g --depth=0` | `npm uninstall -g` |
+| Yarn | `yarn global list --json` | `yarn global remove` |
+| pnpm | `pnpm list -g --json` | `pnpm remove -g` |
+
+---
+
+## Roadmap
+
+- [ ] nvm / pyenv support
+- [ ] Virtual environment detection
+- [ ] Package update detection
+- [ ] Dependency graph visualization
+- [ ] Dark / light mode toggle
+- [ ] Plugin system for new package managers
+- [ ] Windows & Linux support
+
+---
+
+## Contributing
+
+Contributions are what make open source great. Any contribution you make is **hugely appreciated**.
+
+1. Fork the repository
+2. Create a feature branch — `git checkout -b feature/your-idea`
+3. Commit your changes — `git commit -m "Add your feature"`
+4. Push to the branch — `git push origin feature/your-idea`
+5. Open a Pull Request
+
+</a>
+
+---
+
+## License
+
+Distributed under the **MIT License** — see [`LICENSE`](LICENSE) for details.
+
+---
+
+<div align="center">
+  <sub>Built with care for developers who just want to see what's on their machine.</sub>
+</div>

package/cli/Dockerfile

@@ -0,0 +1,22 @@
+# devenv-inspector-cli
+# Provides a ready-to-run environment with Python + Node.js + the CLI pre-installed.
+# Note: commands inspect packages inside this container, not your host machine.
+
+FROM node:20-slim
+
+# Install Python 3 + pip
+RUN apt-get update && apt-get install -y \
+    python3 \
+    python3-pip \
+    bash \
+    --no-install-recommends \
+    && rm -rf /var/lib/apt/lists/*
+
+# Use bash as the shell (zsh is not available in slim images)
+ENV SHELL=/bin/bash
+
+# Install the CLI globally from npm
+RUN npm install -g devenv-inspector-cli
+
+ENTRYPOINT ["devenv"]
+CMD ["--help"]

package/cli/README.md

@@ -0,0 +1,139 @@
+<div align="center">
+  <h1>devenv-inspector-cli</h1>
+  <p>Inspect runtimes and manage global packages from your terminal — no GUI required.</p>
+
+  <p>
+    <img src="https://img.shields.io/badge/version-0.1.0-5a7af5?style=for-the-badge" alt="Version" />
+    <img src="https://img.shields.io/badge/platform-macOS-lightgrey?style=for-the-badge&logo=apple" alt="Platform" />
+    <img src="https://img.shields.io/badge/license-MIT-44c98b?style=for-the-badge" alt="License" />
+    <img src="https://img.shields.io/npm/v/devenv-inspector-cli?style=for-the-badge&logo=npm&color=cc3534" alt="npm" />
+  </p>
+
+  <img src="https://raw.githubusercontent.com/Ali-Aldahmani/devenv-inspector/main/cli/media/screenshot-cli.png" alt="devenv-inspector-cli screenshot" width="720" />
+</div>
+
+> Prefer a desktop GUI? Check out **[DevEnv Inspector](https://github.com/Ali-Aldahmani/devenv-inspector)** — the same features in a native macOS window.
+
+---
+
+## Install
+
+### via npm
+```bash
+npm install -g devenv-inspector-cli
+```
+
+### via Docker
+No Node.js or Python required — just Docker:
+
+```bash
+# Pull and run
+docker run --rm ghcr.io/ali-aldahmani/devenv-inspector-cli list
+docker run --rm ghcr.io/ali-aldahmani/devenv-inspector-cli packages
+docker run --rm ghcr.io/ali-aldahmani/devenv-inspector-cli info python
+
+# Or build locally from source
+git clone https://github.com/Ali-Aldahmani/devenv-inspector.git
+cd devenv-inspector/cli
+docker build -t devenv-inspector-cli .
+docker run --rm devenv-inspector-cli list
+```
+
+> **Note:** Docker runs in an isolated container — it shows packages installed inside the image, not on your host machine. Use the npm install for inspecting your own machine.
+
+---
+
+## Commands
+
+### `devenv list`
+Show all installed runtimes with their versions.
+
+```
+$ devenv list
+
+  DevEnv Inspector — Runtimes
+
+  Python      3.13.5
+  Conda       26.1.0
+  Node.js     24.13.0
+  npm         11.6.2
+```
+
+---
+
+### `devenv packages [--runtime <mgr>]`
+List all global packages. Optionally filter by manager.
+
+```bash
+devenv packages                  # all packages
+devenv packages --runtime pip    # pip only
+devenv packages --runtime conda  # conda only
+devenv packages --runtime npm    # npm only
+```
+
+```
+$ devenv packages --runtime npm
+
+  DevEnv Inspector — Packages (npm)
+
+  ┌──────────────────────────────────────┬────────────────────┬──────────┐
+  │ Name                                 │ Version            │ Manager  │
+  ├──────────────────────────────────────┼────────────────────┼──────────┤
+  │ electron                             │ 33.4.0             │ npm      │
+  └──────────────────────────────────────┴────────────────────┴──────────┘
+  1 package
+```
+
+---
+
+### `devenv uninstall <package> --runtime <mgr>`
+Uninstall a package with a confirmation prompt.
+
+```bash
+devenv uninstall requests --runtime pip
+devenv uninstall numpy --runtime conda
+devenv uninstall electron --runtime npm
+```
+
+```
+$ devenv uninstall requests --runtime pip
+? Uninstall requests via pip? (y/N) y
+
+  ✓ requests uninstalled successfully.
+```
+
+---
+
+### `devenv info <runtime>`
+Show detailed info for a single runtime.
+
+```bash
+devenv info python
+devenv info conda
+devenv info node
+devenv info npm
+```
+
+```
+$ devenv info python
+
+  Python
+
+  Status   Installed
+  Version  3.13.5
+  Packages 211 pip packages
+```
+
+---
+
+## How It Works
+
+All commands run through your login shell (`zsh -i -l -c`) — the same approach as the GUI app — so conda, pyenv, nvm, and other shell-managed tools are always found.
+
+Package names are validated against `/^[a-zA-Z0-9._\-@/]+$/` before any shell call to prevent injection.
+
+---
+
+## License
+
+MIT — see [LICENSE](../LICENSE)

package/cli/bin/devenv.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { Command } from 'commander'
+import { listCommand } from '../src/commands/list.js'
+import { packagesCommand } from '../src/commands/packages.js'
+import { uninstallCommand } from '../src/commands/uninstall.js'
+import { infoCommand } from '../src/commands/info.js'
+
+const program = new Command()
+
+program
+  .name('devenv')
+  .description('Inspect and manage your development runtimes and global packages')
+  .version('0.1.0')
+
+program
+  .command('list')
+  .description('Show all installed runtimes and their versions')
+  .action(listCommand)
+
+program
+  .command('packages')
+  .description('List all global packages')
+  .option('-r, --runtime <manager>', 'filter by manager: pip, conda, or npm')
+  .action(packagesCommand)
+
+program
+  .command('uninstall <package>')
+  .description('Uninstall a package')
+  .requiredOption('-r, --runtime <manager>', 'package manager: pip, conda, or npm')
+  .action(uninstallCommand)
+
+program
+  .command('info <runtime>')
+  .description('Show detailed info for a runtime (python, conda, node, npm)')
+  .action(infoCommand)
+
+await program.parseAsync(process.argv)