Automatically discover, understand, monitor, and launch every coding project on your computer — 100% locally & privately
The Problem • Features • Quick Start • Architecture • Privacy • Roadmap • Contributing
Note
DevDock runs entirely on your own machine. It reads only filesystem metadata (directory trees, marker files, Git porcelain) and never uploads your source code anywhere.
Developers accumulate dozens or hundreds of coding projects across ~/Projects, ~/Developer, ~/Code, Documents, and hidden corners of their disks.
Without DevDock, answering simple questions requires constant terminal navigation:
- Where is that old Flutter app or Rust CLI script I wrote last year?
- Which local ports (
localhost:3000,5173,8000) are active right now? - How are my microservices, frameworks, and workspace repositories connected?
- How many gigabytes of dead
node_modulesortargetbuild cache are hogging my disk? - Do I have uncommitted Git changes before pushing?
- Is this project missing
.envkeys from.env.exampleor leaking keys to Git? - Is this project missing
node_modulesor.venvdependencies?
DevDock is your local development command center. It automatically discovers your projects, analyzes their tech stack, monitors active dev servers, audits health, and lets you open them in your preferred editor or terminal with a single click.
- Visual Topological Map: Render real-time interactive node-link diagrams connecting Projects, Workspaces, Technologies, and Active Listening Ports.
- Cross-Project Clustering: Discover shared tech stacks, monorepo connections, and active port bindings at a glance.
- 1-Click Deep Navigation: Click any graph node to inspect dependencies and jump directly into the full Project Detail workspace.
- Zero-Cloud Local Heuristics Engine: Generates instant architecture pattern inferences, recommended run commands, and maintenance tips without sending a single byte over the network.
- Intelligent Health Diagnostics: Proactively identifies repository risks, missing dependencies, unignored secret files, and uncommitted git branches.
- Background Menu Bar Resident: DevDock sits in your macOS menu bar or Windows system tray for zero-friction access.
- 1-Click Window Toggle: Left-click the menu bar icon to instantly show or hide DevDock.
- Tray Quick Menu: Right-click tray menu for rapid actions (Show Window, Hide, Quit).
- Command Palette HUD: Instant search across projects, tech stacks, and actions via
⌘K/Ctrl+K.
- Interactive Disk Footprint Inspector: Accurately calculates project footprint and isolates disposable build cache folders (
node_modules,target,.dart_tool,build,.venv,.next,dist,Pods,DerivedData). - One-Click Safe Cache Cleanup: Reclaim gigabytes of disk space with 1-click without affecting source code.
- Stale Project Detector: Identifies abandoned projects untouched for >90 days that are silently wasting disk space with heavy build artifacts.
- Global Disk Janitor Dashboard: Overview of total reclaimable storage across all repositories with batch cleanup capability.
.env.examplevs.envDiff Checker: Automatically extracts environment variable keys and warns you when required template keys are missing from your local.env. (Values are never read or stored for 100% privacy).- GitIgnore Secret Leak Auditor: Scans for sensitive files (
.env,id_rsa,*.key,credentials.json) and flags any unignored credentials with a 1-click "+ Add to .gitignore" button. - Runtime Toolchain Inspector: Reads
.nvmrc,.python-version, andrust-toolchain.tomlto detect version mismatches against your installed runtime versions.
- Custom Project Workspaces: Group related repositories into color-coded collections (e.g. Client Work, Microservices, Open Source).
- Bulk
⬇️ Pull All: Synchronize and update all Git repositories in your active workspace simultaneously with animated background progress and detailed result reports. - Bulk
📋 Git Audit: Audit uncommitted changes across all workspace projects in one overview.
- Interactive Library Parser: Automatically parses
package.json(dependencies&devDependencies),Cargo.toml, andrequirements.txtinto a clean visual dependency list.
- Curated Dark Themes: Switch seamlessly between Emerald Night, Cyberpunk Neon, Nordic Frost, Monokai Gold, and Dracula Pink.
- Smart Listening Port Scanner: Automatically detects active TCP dev servers (
localhost:3000,5173,8000,5432,6379, etc.). - Noise Filter: Intelligently filters out background desktop applications (Spotify, Discord, Steam, Dropbox, system daemons).
- Interactive Dev Grid: Glassmorphism cards with pulsing status dots, PID badges, and 1-click browser launchers.
- Extensible Detector Architecture: Instant recognition for Git, Node.js, Python, Rust, Go, Flutter, .NET, Docker, Unity, and Java.
- Read-Only Git Metadata: Shows current branch, clean/dirty status, uncommitted file counts (
modified,staged,untracked), last commit message, and remote URL.
- Automatic Repository Parsing: Resolves
owner/repofrom remote URLs. - 1-Click Quick Actions: Direct links to Repository, Issues (
/issues), and Pull Requests (/pulls).
- Deterministic Health Scoring (0–100): Evaluates missing dependencies (
node_modules,.venv), documentation presence (README.md), and Git cleanliness. - Visual Health Tags & Indicators: Color-coded badges (
🟢 Ready,🟡 Mod,🔴 Unhealthy) on project cards and detail views. - Detected Package Scripts: Reads
package.json(npm run dev),Cargo.toml(cargo run), andMakefilescripts. - Custom Shell Commands: Add your own project commands (
cargo watch,docker compose up) saved locally in SQLite and trigger them in 1 click.
- Custom Project Tags: Categorize projects (
open-source,client-work,side-project). - Auto-Saved Markdown Notes: Keep project TODOs, notes, and reminders saved per project in local SQLite.
- Command Palette (
⌘K/Ctrl+K): Global instant search for projects, actions, and settings. - Recently Opened Strip: Quick launcher for recently opened projects.
- Configurable Editors & Terminals: Auto-detects Antigravity IDE, Cursor, VS Code, Zed, Windsurf, JetBrains suite (WebStorm, PyCharm, IntelliJ, CLion, RustRover), iTerm2, Kitty, Alacritty, Warp, Terminal.app, etc.
Launch DevDock instantly from any terminal window :
# 1. Clone the repository & link the CLI globally
git clone https://github.com/ArdaTkn/DevDock.git
cd DevDock && npm install && npm link
# 2. Type 'devdock' anywhere in your terminal to launch DevDock!
devdock# Launch DevDock GUI App
devdock
# Check active listening dev ports (3000, 5173, 8000...)
devdock ports
# Pull latest code from GitHub & rebuild automatically
devdock update
# Show DevDock system status & database info
devdock status
# Scan specific folder
devdock scan ~/Projects
# Print CLI help
devdock helpTip
After running npm link once, simply typing devdock in any terminal opens DevDock directly.
┌─────────────────────────────────────────────────────────┐
│ Frontend: React 18 + TypeScript + Vite │
│ (Zustand State, Lucide Icons, Modern Dark UI Themes) │
└────────────────────────────┬────────────────────────────┘
│ Tauri 2 IPC Commands
┌────────────────────────────▼────────────────────────────┐
│ Backend: Rust + Tauri 2 │
│ • discovery/ (Smart parallel directory traversal) │
│ • security/ (.env diffing & secret leak prevention) │
│ • git/ (Read-only Git CLI porcelain parser) │
│ • processes/ (Smart filtering dev listening ports) │
│ • docker/ (Docker container inspector) │
│ • health/ (Deterministic project health audit) │
│ • system/ (Safe OS launcher & script runner) │
│ • storage/ (Embedded SQLite - rusqlite) │
│ • watch/ (Incremental FS events - notify crate) │
└────────────────────────────┬────────────────────────────┘
┌────────▼────────┐
│ SQLite Database│ (Metadata & paths only)
└─────────────────┘
For full architecture details, check out docs/ARCHITECTURE.md.
- Local-First & Offline: DevDock works 100% offline. No cloud, no external servers, no user accounts.
- No Source Code Uploads: DevDock scans only file/folder names, marker files (like
package.jsonscript keys), and Git status. Your source code,.envfiles, and secrets are never read or transmitted. - Zero Telemetry: No tracking, no background pinging, no analytics.
- Safe Process Spawning: Every editor, terminal, or script runner uses explicit argv (
Command::new(bin).args(...)) rather than raw shell execution, preventing shell-injection vulnerabilities.
Read our full Security Policy and docs/SECURITY.md.
- v0.1.0 — Core scanner, Git metadata parser, project card grid, technology detectors.
- v0.2.0 — Command Palette (
⌘K), FileSystem Watcher (notify), Recently Opened strip, Code Editor & Terminal selector. - v0.3.0 — Smart Listening Port scanner (
localhost:3000,5173), Docker container inspector, deterministic project health audit. - v0.4.0 — GitHub integration, custom project tags, auto-saved Markdown notes, configurable custom shell commands.
- v0.5.0 — Project dependency visualizer, 6 custom dark themes, global terminal CLI (
devdock,devdock update,devdock ports). - v0.6.0 — Workspaces & Project Collections, Bulk Git sync ("⬇️ Pull All", "📋 Git Audit"), in-app workspace manager.
- v0.7.0 —
.env.examplevs.envdiff inspector, GitIgnore secret leak prevention, runtime toolchain version warnings. - v0.8.0 — Disk Space Hog visualizer, 1-click safe build cache cleaner (
node_modules,target,.dart_tool), stale project detector. - v0.9.0 — macOS Menu Bar & Windows Tray popover widget, 1-click toggle, quick tray menu.
- v1.0.0 — Interactive Architecture Knowledge Graph & 100% Privacy-First Offline Local AI Insights! 🏆🎉
Check out docs/PLAN.md for full roadmap details.
Contributions are warmly welcomed! Please read CONTRIBUTING.md to learn how to add new technology detectors or contribute to the Tauri/React codebase. Please follow our Code of Conduct.
DevDock is released under the MIT License © Arda Tekin.