devintelligence
v1.0.1
Published
DEVINTELLIGENCE — Personal Software Engineering Intelligence System. Understand. Diagnose. Repair. Optimize.
Maintainers
Readme
DEVINTELLIGENCE
Personal Software Engineering Intelligence System
Understand. Diagnose. Repair. Optimize.
DEVINTELLIGENCE is an advanced, locally operating developer intelligence platform and installable library built for daily multi-ecosystem engineering workflows.
It deeply understands your project structure, inspects native mobile configurations (React Native, Expo, Bare RN, Android, iOS), analyzes full-stack web and backend architectures (Next.js, Vite, Node.js, Express, Python, Django), detects architectural, security, and performance bottlenecks, and safely executes verified auto-repairs on disk with automatic rollback snapshots.
⚡ Core Philosophy
- Zero Cloud Dependence: Operates 100% locally on your machine.
- Engineered Correctness: Deep AST and configuration analysis instead of surface-level linting.
- Resilient AI Shield: Integrated with ultra-fast Groq AI (Qwen 27B / Llama 3) for sub-second crash diagnosis. If API limits are reached (HTTP 429) or offline, it never crashes — seamlessly degrading to built-in heuristic rule engines with zero downtime.
- Safe Auto-Remediation: Categorizes all fixes into
SAFE(zero regression risk with timestamped backups),REVIEW REQUIRED, andRISKY.
📦 Installation & Library Usage
Install anywhere in your projects:
# Global CLI Installation
npm install -g devintelligence
# Or install as a development dependency / library in any project
npm install devintelligence --save-devProgrammatic Library API
Import DEVINTELLIGENCE directly into your Node.js, TypeScript, or custom developer automation scripts:
import {
inspectHostEnvironment,
analyzeProjectDirectory,
diagnoseRawErrorLogWithAi,
applyAllSafeRepairsOnDisk,
getProjectReportById,
} from 'devintelligence';
// 1. Audit developer environment runtimes
const envReport = inspectHostEnvironment();
console.log(envReport);
// 2. Perform deep AST & architecture scan on any repository
const report = analyzeProjectDirectory('/path/to/my-react-native-app');
console.log(`Overall Health: ${report.scores.overall}/100`);
// 3. AI-Powered crash trace diagnosis with guaranteed rule fallback
const diagnosis = await diagnoseRawErrorLogWithAi(metroErrorStack);
console.log(diagnosis.summary, diagnosis.rootCause, diagnosis.safeRepairSteps);
// 4. Automatically apply all safe auto-repairs with rollback protection
const repairResult = applyAllSafeRepairsOnDisk('my-project-id');
console.log(`Applied ${repairResult.appliedRepairs.length} safe patches.`);🚀 CLI Commands
Run directly without installing via npx:
# Initialize DEVINTELLIGENCE in current directory
npx devintelligence init
# Audit host environment (Node, Expo, Android SDK, Gradle, CocoaPods, Xcode)
npx devintelligence doctor
# Deep AST scan on current project or registered fixture
npx devintelligence scan [--project=<id>] [--ci]
# Diagnose any build or runtime crash trace with AI + Rule Fallback
npx devintelligence diagnose "<error_trace>"
# Apply all validated SAFE auto-repairs on disk with backup
npx devintelligence fix [--project=<id>]
# Generate AI executive engineering advice & prioritized action plan
npx devintelligence advice [--project=<id>]
# Ask the interactive AI technical assistant directly
npx devintelligence ai "How do I optimize FlatList windowing in React Native?"
# Run self-testing verification suite across 5 multi-ecosystem fixtures
npx devintelligence test
# Launch desktop engineering workstation on http://localhost:3000
npx devintelligence dashboard📱 React Native & Native Intelligence
Dedicated, deeply implemented intelligence for Expo Managed, Expo Prebuild (CNG), and Bare React Native CLI:
- Initial Project Doctor: Inspects Node, npm, yarn, pnpm, Bun, Expo SDK, Android SDK, platform-tools, build-tools, JDK, Gradle, AGP, Kotlin, Xcode (macOS), iOS deployment targets, CocoaPods, Metro, Babel, and TypeScript.
- Error Intelligence: Traces root causes for Metro bundler crashes, Reanimated Babel plugin ordering, Android Gradle merger failures, missing permissions, Hermes runtime exceptions, CocoaPods linkage issues, and Red Screen traces.
- Component Intelligence: Detects unnecessary re-renders, missing list keys, FlatList performance anti-patterns, hook memory leaks (e.g. uncleaned
AppStatelisteners), and accessibility gaps. - Android Intelligence: Full inspection of
AndroidManifest.xml,build.gradle,settings.gradle,gradle.properties, target SDK, and cleartext HTTP policies. - iOS Intelligence: Deep audit of
Podfile, deployment targets, privacy usage keys inInfo.plist, and native framework linking.
🖥️ 18-Module Developer Workstation
To launch the desktop-first developer interface locally:
npm run dev
# or
npx devintelligence dashboardOpen http://localhost:3000 to access all 18 dedicated modules:
- Core: Command Center, Project Explorer, Project Health.
- Mobile & Native: React Native Doctor, Android Diagnostics, iOS Diagnostics, Error Diagnostics.
- Deep Analysis: Code Intelligence, Design Intelligence, Performance Lab, Security Audit, Dependency Intelligence.
- Repair & Delivery: Auto Repair Center, Visual Testing, Quality Gate, Project History, Environment Manager, Settings & MCP.
🛠️ Model Context Protocol (MCP) Tools
DEVINTELLIGENCE exposes local MCP tools compatible with Claude Desktop, Cursor, Antigravity, and Gemini:
inspect_projectdiagnose_erroranalyze_react_nativeinspect_android_environmentfind_unused_filesapply_safe_fixverify_repair
📄 License
MIT © 2026 DEVINTELLIGENCE Engineering Team
