Dev-Janitor

Dev Janitor

---

Overview

Dev Janitor helps keep a local development machine under control. It focuses on the files, caches, services, and configuration drift that accumulate during everyday work.

Features

Cleanup

• Scan project directories for common development artifacts such as node_modules, target, logs, caches, and temporary files.
• Detect ephemeral leftovers from AI coding tools without flagging active project config files such as .codex/config.toml, .claude/settings.json, .goosehints, or .junie/AGENTS.md as junk.
• Review and remove AI chat history, cache, session state, and debug files on a per-project basis.
• Clean official GitHub Copilot CLI session targets without deleting the whole .copilot configuration directory.

Tool Management

• Inspect installed tools across Node, Python, Rust, Go, and related ecosystems.
• 检查和更新常见全局包，区分已确认最新与未检查更新的状态，并保留失败原因。
• 更新命令说明 列出 AI Agent CLI、Pi 扩展包和包管理器命令及安装渠道限制。
• Manage 25 AI CLI tools from one interface, including Codex, Claude Code, Kiro, Factory Droid, Mistral Vibe, Qoder CLI, Pi, OpenCode, Gemini CLI, and GitHub Copilot CLI.
• Follow official native install and self-update flows where available; legacy Amazon Q installations are guided through migration to Kiro CLI.

Security Scan

• Check for risky local tool configurations and known vulnerable setups.
• Flag ports that should usually listen on localhost only.
• Detect API keys, GitHub tokens, and provider credentials stored in common configuration files.
• Inspect MCP server configurations for patterns that can lead to credential exposure or SSRF.

System Utilities

• Inspect long-running development processes.
• Find which process is using a specific port.
• Review PATH and shell configuration issues, including persisted Windows system/user PATH entries.

Screenshots

Installation

The latest stable version is published from the v* tag release workflow after a preflight validation pass. Installed production builds check signed GitHub releases and can download, install, and relaunch into an update from inside the app.

Windows

Download the latest files from Releases:

• Installer: .msi
• Portable: *_portable.zip

macOS

Download the .dmg from Releases. The first launch may require Right Click > Open because of Gatekeeper.

Linux

AppImage, .deb, and .rpm packages are published on the Releases page.

Development

Dev Janitor is built with Tauri 2, React 19, and Rust.

Development setup

Prerequisites

• Node.js 24 LTS+
• pnpm 11.15.1+
• Rust 1.97.1

Setup

git clone https://github.com/cocojojo5213/Dev-Janitor.git
cd Dev-Janitor
corepack enable pnpm
pnpm install
pnpm tauri dev

Validation

pnpm lint
pnpm validate:release
pnpm build
pnpm test
cargo fmt --check --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
cargo check --manifest-path src-tauri/Cargo.toml --target x86_64-pc-windows-gnu

pnpm test runs the Rust core tests without compiling the Tauri desktop shell. Use pnpm test:rust:full when changing Tauri command wiring. Default Cargo and Tauri builds still enable the full desktop feature.

The AI CLI catalog is checked for local metadata drift on every CI run. A separate weekly workflow verifies official documentation and package registry endpoints without slowing down pull requests.

Contributing

Please read CONTRIBUTING.md before opening a pull request.

• Keep pull requests focused.
• Update documentation when behavior or setup changes.
• Report security issues privately as described in SECURITY.md.
• Follow the expectations in CODE_OF_CONDUCT.md.

Project Docs

• Contributing Guide
• Release and Build History
• Code of Conduct
• Security Policy
• Support

License

This project is available under the MIT License.

Contact

Email: [email protected]

---