devscope
Development environment at a glance — detect, install, and manage your dev tools. Scan & visualize all local code projects. MCP-native.
Why devscope?
Setting up a new machine or onboarding onto a team? devscope answers three questions instantly:
- What's installed? — Detect runtimes, package managers, and version managers in seconds.
- What's missing? — One command to install everything you need.
- What's on this machine? — Scan all your code projects, see languages, frameworks, Git status, and dependencies at a glance.
It also works as an MCP Server, so AI agents (Cursor, Claude Desktop, etc.) can query your dev environment directly.
Features
- Environment Detection — Node, Go, Python, Rust, Java, Ruby, PHP, .NET, Swift, Dart + package managers + version managers
- One-Click Setup — Interactively install missing tools via Homebrew / apt / winget / official installers
- Project Scanner — Discover all code projects across your machine, extract metadata, frameworks, Git info
- Visual Dashboard — Self-contained HTML report with Environment / Projects / Insights views
- MCP Server — AI agents can detect environments, install tools, scan projects, and generate reports
- Beautiful CLI — Colorful terminal output with progress indicators
Quick Start
# No install needed — run directly
npx devscope env # Show what's installed
npx devscope setup # Install missing tools
npx devscope scan # Scan your projects
npx devscope list # List all projects
npx devscope report # Generate visual report
Or install globally:
npm install -g devscope
CLI Commands
| Command | Description |
|---|---|
devscope env | Detect installed runtimes, package managers, version managers |
devscope setup | Interactively install missing tools |
devscope setup --all | Install all missing tools without prompting |
devscope setup --only node,go | Install specific tools |
devscope scan [dirs...] | Scan directories for code projects |
devscope list | List scanned projects |
devscope list --lang node | Filter by language |
devscope list --active | Show only active projects |
devscope show <name> | Show detailed info for a project |
devscope report | Generate HTML report and open in browser |
devscope mcp | Start as MCP Server |
MCP Integration
devscope works as an MCP Server for AI-powered development tools.
Cursor
Settings → MCP → Add:
{
"mcpServers": {
"devscope": {
"command": "npx",
"args": ["-y", "devscope", "mcp"]
}
}
}
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"devscope": {
"command": "npx",
"args": ["-y", "devscope", "mcp"]
}
}
}
MCP Tools
| Tool | Description |
|---|---|
detect_environment | Detect all installed runtimes and tools |
install_tool | Install a specific runtime or package manager |
scan_directories | Scan directories and discover projects |
generate_report | Generate visual HTML report |
Example Prompts
"What development tools do I have installed?"
"Install Go and Rust on my machine"
"Scan ~/workspace and show me all my projects"
"Generate a report of all my code projects"
Detected Technologies
Runtimes
Node.js · Go · Python · Rust · Java · Ruby · PHP · .NET · Swift · Dart
Package Managers
npm · yarn · pnpm · bun · cargo · pip · uv · composer · gem · Homebrew
Version Managers
nvm · fnm · volta · n · pyenv · rustup · mise · asdf · sdkman · rbenv
Project Languages
Node.js (package.json) · Python (requirements.txt, pyproject.toml) · Go (go.mod) · Java (pom.xml, build.gradle) · Rust (Cargo.toml)
Frameworks
React · Vue · Angular · Svelte · Next.js · Nuxt · Electron · Tauri · Express · NestJS · Fastify · Koa
Output
| File | Path | Description |
|---|---|---|
| JSONL | ~/.devscope/results.jsonl | Raw scan data |
| HTML | ~/.devscope/report.html | Visual report |
Contributing
See CONTRIBUTING.md for guidelines.