{"id":49887092,"url":"https://github.com/alexwhin/deptox","last_synced_at":"2026-05-15T18:36:33.370Z","repository":{"id":332535799,"uuid":"1132678311","full_name":"alexwhin/deptox","owner":"alexwhin","description":"𝌤 deptox  — macOS app for reclaiming disk space from dependency directories scattered across your filesystem.","archived":false,"fork":false,"pushed_at":"2026-01-14T09:35:29.000Z","size":14932,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-14T13:41:43.694Z","etag":null,"topics":["cleanup","developer-tool","macos","rust","storage","tauri","typescript"],"latest_commit_sha":null,"homepage":"","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/alexwhin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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-01-12T09:51:41.000Z","updated_at":"2026-01-14T09:35:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alexwhin/deptox","commit_stats":null,"previous_names":["alexwhin/deptox"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/alexwhin/deptox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexwhin%2Fdeptox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexwhin%2Fdeptox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexwhin%2Fdeptox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexwhin%2Fdeptox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexwhin","download_url":"https://codeload.github.com/alexwhin/deptox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexwhin%2Fdeptox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33074906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cleanup","developer-tool","macos","rust","storage","tauri","typescript"],"created_at":"2026-05-15T18:36:31.741Z","updated_at":"2026-05-15T18:36:33.365Z","avatar_url":"https://github.com/alexwhin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 𝌤 deptox\n\n[![macOS](https://img.shields.io/badge/platform-macOS%2011.0%2B-lightgrey.svg)](https://www.apple.com/macos/)\n[![Tauri](https://img.shields.io/badge/built%20with-tauri-FFC131.svg)](https://tauri.app/)\n[![Codecov](https://img.shields.io/codecov/c/github/alexwhin/deptox?logo=codecov\u0026color=f11f7a)](https://codecov.io/gh/alexwhin/deptox)\n![Build](https://img.shields.io/github/actions/workflow/status/alexwhin/deptox/pipeline.yml?branch=main\u0026color=2ea44f)\n\n![deptox banner](public/banner.png)\n\nmacOS menubar app for reclaiming disk space from dependency directories scattered across your filesystem.\n\nGigabytes sitting idle in forgotten `node_modules`, `vendor`, `Pods`, and `.venv` folders. deptox finds them, shows you what's consuming space, and lets you delete them selectively—all from your menubar.\n\n## Why deptox?\n\nEvery project you clone or experiment with leaves behind dependency folders. That _\"I'll get back to this\"_ repo from six months ago still has 800MB of packages sitting there. Multiply that across dozens of projects and you're looking at tens of gigabytes of wasted space.\n\n**deptox gives you control:**\n\n- **Fast scanning** across your entire filesystem\n- **Multi-language support** (TypeScript, PHP, Ruby, iOS, Python, Elixir, Dart, Go)\n- **Safe deletion** via Trash (easily recoverable)\n- **Threshold alerts** when space usage exceeds your limit\n- **Background monitoring** with periodic scans\n\n![deptox banner](public/deptox.gif)\n\n## Installation\n\n### Download\n\nGrab the latest release from [GitHub Releases](https://github.com/alexwhin/deptox/releases).\n\n\u003e **Important**: macOS may show \"deptox.app is damaged and can't be opened\" because the app is not notarised with Apple. After downloading, run this command in Terminal to allow the app to open:\n\u003e\n\u003e ```bash\n\u003e xattr -cr /Applications/deptox.app\n\u003e ```\n\n### Build from Source\n\n```bash\ngit clone https://github.com/alexwhin/deptox.git\ncd deptox\npnpm install\npnpm tauri build\n```\n\n## Quick Start\n\n1. Click the deptox icon in your menubar\n2. The app scans from your home directory automatically\n3. Click any directory to open it in Finder\n4. Use the context menu (⋮) to:\n   - Rescan a specific directory\n   - Delete to Trash\n5. Access settings via the gear icon to:\n   - Choose which dependency types to scan\n   - Set your alert threshold\n   - Change the root scan directory\n\n## Internationalization\n\nCurrently supports 12 languages (automatic language detection based on system settings):\n\n🇬🇧 English 🇩🇪 German 🇪🇸 Spanish 🇫🇷 French 🇮🇳 Hindi 🇮🇹 Italian\n\n🇯🇵 Japanese 🇰🇷 Korean 🇵🇹 Portuguese 🇷🇺 Russian 🇨🇳 Chinese 🇸🇦 Arabic\n\n## Supported Directory Types\n\n| Type           | Language/Framework | Typical Size |\n| -------------- | ------------------ | ------------ |\n| `node_modules` | Node.js/JavaScript | 100MB - 1GB+ |\n| `vendor`       | PHP/Composer       | 50MB - 500MB |\n| `vendor`       | Ruby/Bundler       | 50MB - 300MB |\n| `Pods`         | iOS/CocoaPods      | 100MB - 1GB+ |\n| `.venv`/`venv` | Python virtualenv  | 50MB - 300MB |\n| `deps`         | Elixir/Mix         | 20MB - 200MB |\n| `.dart_tool`   | Dart/Flutter       | 10MB - 100MB |\n| `pkg/mod`      | Go modules         | 50MB - 500MB |\n\n## Safety Features\n\n- **Trash integration**: Deleted directories go to macOS Trash, not permanent deletion\n- **Symlink detection**: Warns when directories contain only symbolic links\n- **iCloud awareness**: Identifies directories stored in iCloud requiring download before deletion\n- **Size verification**: Shows exact space consumption before deletion\n\n## Development\n\n```bash\npnpm tauri dev        # Start app in dev mode\n\npnpm test             # Run all tests\npnpm test:ts          # Frontend tests only\npnpm test:rust        # Backend tests only\n\npnpm build            # Build frontend\npnpm tauri build      # Build production app\n\nnpx tsc --noEmit      # TypeScript type checking\n```\n\n## Privacy\n\ndeptox operates entirely locally. No data is collected, transmitted, or stored externally. Filesystem scanning happens on your machine, results stay on your machine. Please see [PRIVACY.md](PRIVACY.md) for details.\n\n## Contributing\n\nContributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on submitting issues and pull requests.\n\n### Commit Convention\n\nThis project uses [Conventional Commits](https://www.conventionalcommits.org/). Commit messages are enforced via commitlint.\n\nFormat: `type(scope): subject`\n\n**Types**: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`\n\nExamples:\n\n```bash\nfeat: add threshold customization to settings\nfix: prevent deletion of symlink-only directories\ndocs: update installation instructions\n```\n\n## Distribution\n\nDistributed via **GitHub Releases** as downloadable `.dmg` files with built-in auto-updates. App Store sandboxing restricts filesystem access to only user-selected files. Since deptox needs to scan your entire filesystem for dependency directories, a sandboxed version would defeat the app's core purpose.\n\n## Releasing\n\nFor maintainers:\n\n- [VERSION_MANAGEMENT.md](VERSION_MANAGEMENT.md) - Modern automated version management\n- [RELEASE.md](RELEASE.md) - Complete release process, builds, and code signing\n\n## License\n\nThis project is released under the MIT License.\nCreated and maintained by [Alex Whinfield](https://github.com/alexwhin).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexwhin%2Fdeptox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexwhin%2Fdeptox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexwhin%2Fdeptox/lists"}