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:

1. What's installed? — Detect runtimes, package managers, and version managers in seconds.
2. What's missing? — One command to install everything you need.
3. 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.

License

MIT