Devscope: Code intelligence at a glance
Analyze any codebase in seconds. Get a maintainability grade, risk level, onboarding difficulty, and CI-ready quality gates—zero configuration required.
Perfect for
- ✓Enforcing maintainability standards across teams
- ✓Monitoring tech debt trends in CI pipelines
- ✓Gating releases on code health thresholds
- ✓Onboarding new contributors with clear quality metrics
Devscope
Open Source CLI
Requirements
Install via pipx (recommended):
pipx install devscopeInstall and scan in 10 seconds
Blazing Fast
Most projects analyze in under 1 second. Intelligent caching provides 10-20x speedup on repeat scans. No waiting, instant insights.
Zero Config
No YAML files, no setup, no learning curve. Just run devscope scan and get actionable insights. Works out of the box with sensible defaults.
Language Agnostic
Analyzes Python, JavaScript, TypeScript, Go, Rust, Java, C++, and more. Provides multi-language repository intelligence with full context.
Comprehensive Code Intelligence
Everything you need to understand and improve code quality.
Maintainability Grading (A-F)
Get a clear A-F grade based on code complexity, test coverage, structure, and git activity. Know where your codebase stands at a glance.
Risk Assessment
Identifies Low, Medium, or High risk levels based on complexity, file sizes, test coverage, and hotspots. Prevent tech debt from accumulating.
Onboarding Difficulty
Rates onboarding as Easy, Moderate, or Hard based on codebase size, complexity, and documentation. Help new contributors get up to speed faster.
CI Quality Gates
Enforces thresholds with exit codes. Fail builds when grade < B, risk > Medium, or onboarding > Hard. Keep quality standards high.
GitHub Action Integration
Official GitHub Action posts health metrics on PRs automatically. Sticky comments, no spam, instant feedback for developers.
Test Coverage Detection
Automatically detects test files and calculates test-to-code ratio. Understand test coverage without configuration.
Multiple Installation Options
Choose the method that works best for your workflow.
pipx (Recommended)
pipx install devscopeIsolated environment, automatic PATH configuration, clean uninstall.
Homebrew (macOS)
brew install devscopeNative macOS package manager integration.
From Source
git clone https://github.com/EhsanAzish80/Devscope.git
cd Devscope
uv sync
uv run devscope scanFor contributors or custom builds.
PyPI
pip install devscopeStandard Python package installation.
Frequently Asked Questions
Does Devscope require configuration?
No. Devscope works out of the box with zero configuration. Just install and run 'devscope scan' on any codebase to get instant insights. No YAML files, no setup wizards, no learning curve.
What languages does Devscope support?
Devscope is language-agnostic. It analyzes Python, JavaScript, TypeScript, Go, Rust, Java, C++, and more. It provides multi-language repository intelligence with full context, making it ideal for polyglot projects.
How fast is Devscope?
Blazing fast. Most projects analyze in under 1 second. With intelligent caching, repeat scans are 10-20x faster. For comparison, a repository with 45,000 lines of code scans in ~0.82 seconds.
Can I use Devscope in CI/CD pipelines?
Yes! Devscope includes CI-ready quality gates with exit codes, JSON output for automation, and an official GitHub Action for automatic PR comments. Use 'devscope ci --fail-under B' to enforce quality thresholds and gate releases.
Is Devscope open source?
Yes! Devscope is MIT licensed and fully open source. The source code is available on GitHub, and contributions are welcome. Check out the repository and contributing guidelines to get started.
What's the difference between 'scan' and 'ci' commands?
'devscope scan' provides beautiful terminal output perfect for local development. 'devscope ci' is CI-optimized with JSON output and quality gates. Use 'ci' in pipelines with flags like --fail-under, --max-risk, and --max-onboarding to enforce standards.
Start analyzing your codebase in seconds
Zero configuration. Language-agnostic. Blazing fast. Install Devscope today and get instant insights into code quality, maintainability, and tech debt.
pipx install devscopeMIT Licensed • Cross-platform • Python 3.9+