Developer Assistant

A reusable, production-grade Developer Productivity & Project Assistant for Visual Studio Code. Built to adapt seamlessly across your current and future projects—from Next.js, Laravel, and NestJS to Angular, React, Symfony, CodeIgniter, and Node.js.

Overview

Modern software development often spans multiple language ecosystems, stacks, and frameworks. Developer Assistant is an intelligent, extensible VS Code extension that understands the project open in your workspace and dynamically surfaces the exact tools, diagnostics, generators, and intelligence you need.

It begins with deterministic, local, lightning-fast developer utilities (zero telemetry, zero secret leaks) and provides a pluggable AI architecture for advanced reasoning in V2.

┌─────────────────────────────────────────────────────────────────┐
│                     DEVELOPER ASSISTANT                         │
├─────────────────────────────────────────────────────────────────┤
│  Project: Fitness App (Next.js + TypeScript)                    │
│                                                                 │
│  [✓ Analyze Project]  [✓ Check Environment]  [✓ Generate Code]  │
│  [✓ API Explorer]     [✓ Database Schema]    [✓ Error Analyzer] │
│                                                                 │
│  Health Status:                                                 │
│  ✓ Dependencies (Installed)                                     │
│  ✓ Git (feature/workout-api)                                    │
│  ⚠ Environment (1 missing variable)                             │
└─────────────────────────────────────────────────────────────────┘

Key Features

1. 🔍 Project Analyzer

Inspects your workspace and determines:

• Frameworks: Next.js, Laravel, NestJS, Angular, React, Symfony, CodeIgniter, Express / Node.js
• Languages: TypeScript, JavaScript, PHP, HTML, CSS, SQL (with file metrics)
• Backend Runtime: Node.js, PHP, or client-only
• Databases: PostgreSQL, MySQL, MongoDB, SQLite
• ORMs & Data Layers: Prisma, Eloquent, Doctrine, TypeORM, Sequelize, Mongoose
• Infrastructure & Deployments: Docker, Docker Compose, Cloudflare Wrangler, GitHub Actions, Vercel
• Package Managers: npm, yarn, pnpm, Composer, bun

2. 🩺 Environment Doctor

Identifies configuration pitfalls before runtime exceptions happen:

• Audits system CLI binaries (node, npm, pnpm, yarn, php, composer, git, docker)
• Validates .env and .env.local against .env.example templates
• Flags missing variables and empty secrets without revealing sensitive values
• Diagnoses uninstalled node_modules or vendor/ directories

3. ⚡ Smart Code Generator & Template Engine

Generates idiomatic, project-aligned code based on your active framework:

• Laravel: Controller, Eloquent Model, Blueprint Migration, Form Request, API Resource
• Next.js: Client/Server Component, App Router Page, Route Handler, Server Action, Hook, Zod Schema
• NestJS: Module, Controller, Service, DTO, Entity, Guard
• React: Component, Custom Hook, Context
• Angular: Standalone Component, Service, Guard
• Symfony: Controller, Entity, Service
• Express / Node: Route Handler, Controller, Middleware
• Safety First: File preview, overwrite warning, and non-destructive generation. Custom templates in <root>/templates/ are automatically discovered.

4. 🌐 API Assistant & Route Explorer

Discovers routes, HTTP verbs, and handlers directly from project source files:

• Next.js App Router (app/api/**/route.ts) & Pages Router
• Laravel route definitions (routes/api.php, routes/web.php)
• NestJS decorated controllers (@Controller, @Get, @Post, @Body)
• Express routing declarations
• Detects authentication guards, request validation, and OpenAPI documentation presence

5. 🗄️ Database Assistant

Provides a clear, human-readable schema viewer:

• Parses prisma/schema.prisma models, field types, primary keys, and relations
• Analyzes Laravel Blueprint migrations (database/migrations/*.php)
• Inspects TypeORM entity decorators (@Entity, @Column, @PrimaryGeneratedColumn)
• Flags schema issues such as missing primary keys and unindexed relationships

6. 🚨 Deterministic Error Analyzer

Instant diagnosis for frequent developer errors without waiting for network calls:

• Missing environment variable resolution and likely .env locations
• Database socket and port connection failures (e.g. Prisma P1001, ECONNREFUSED)
• Port conflicts (EADDRINUSE) with resolution steps
• Missing module and package dependencies
• React / Next.js hydration mismatches
• Laravel APP_KEY and Vite manifest exceptions
• Cross-Origin Resource Sharing (CORS) header misconfigurations

7. 🐙 Git Assistant

Displays repository health at a glance:

• Current branch & tracking status
• Modified, staged, and untracked file breakdown
• Recent 5 commits with author and relative timestamp

8. 🛡️ Modular AI Architecture (V2 Ready)

Prepared for LLM-powered code explanation, refactoring, and project query reasoning:

• Modular Provider Interface: Google Gemini, Groq, OpenRouter, and Custom OpenAI-compatible endpoints
• Zero Hardcoded Secrets: Uses VS Code SecretStorage for secure OS-level keychain storage
• Context Privacy Filter: Sanitizes source code, redacts API keys and JWTs, and strictly excludes .env*, .pem, and key files

Extension Architecture

flowchart TD
    Ext[extension.ts] --> Cmd[Command Registry]
    Ext --> Dash[Dashboard Webview]

    subgraph Analyzers
        PA[ProjectAnalyzer] --> FD[FrameworkDetector]
        PA --> DA[DependencyAnalyzer]
        PA --> EA[EnvironmentAnalyzer]
        PA --> GA[GitAnalyzer]
    end

    subgraph Specialized Tools
        CG[CodeGenerator] --> TE[TemplateEngine]
        API[ApiAnalyzer]
        DB[DatabaseAnalyzer]
        ERR[ErrorAnalyzer]
    end

    subgraph AI Layer V2
        AIP[AIProvider Interface]
        CM[ContextManager]
        Gemini[GeminiProvider]
        Groq[GroqProvider]
        OpenRouter[OpenRouterProvider]
        AIP --> CM
        AIP --> Gemini
        AIP --> Groq
        AIP --> OpenRouter
    end

    Cmd --> PA
    Cmd --> EA
    Cmd --> CG
    Cmd --> API
    Cmd --> DB
    Cmd --> ERR
    Dash --> PA
    Dash --> EA
    Dash --> CG
    Dash --> API
    Dash --> DB
    Dash --> ERR

Command Palette Reference

Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) and type:

Real-World Usage Case Studies

1. Fitness Tracker Application

• Stack: Next.js 14 (App Router) + TypeScript + Prisma + PostgreSQL + Cloudflare
• Detection:
  • Automatically identifies Next.js as primary framework with React secondary
  • Discovers PostgreSQL datasource via prisma/schema.prisma
  • Discovers Cloudflare deployment via wrangler.toml
  • Routes scanned: /api/workouts, /api/workouts/:id, /api/auth/[...nextauth]
  • Generator offers: Next.js Component, App Router Page, Server Action, Zod Schema

2. Laravel E-Commerce API

• Stack: Laravel 10 + PHP 8.2 + MySQL + Eloquent
• Detection:
  • Identifies artisan and composer.json dependencies
  • Discovers MySQL via .env configuration
  • Models and tables parsed from database/migrations
  • Routes scanned: /api/products, /api/cart, /api/orders
  • Generator offers: API Controller, Eloquent Model, Migration, Form Request, JsonResource

Development & Testing

Prerequisites

• Node.js >= 18.0.0
• npm >= 9.0.0

Setup

# Clone the repository
git clone https://github.com/developer-assistant/developer-assistant.git
cd developer-assistant

# Install development dependencies
npm install

# Compile TypeScript
npm run compile

# Run the automated test suite (23 fixture tests)
npm test

Running the Extension Locally

1. Open the project folder in VS Code.
2. Press F5 to open a new VS Code window with the Extension Development Host.
3. Open any project (e.g. Next.js, Laravel, NestJS, etc.).
4. Run Developer Assistant: Open Dashboard via the Command Palette.

Packaging into VSIX

To package the extension into an installable .vsix file:

npx @vscode/vsce package --no-dependencies

Installing from VSIX

code --install-extension developer-assistant-1.0.0.vsix

Roadmap

• [x] V1: Core Productivity Foundation
  • Universal framework detection (Laravel, Next.js, NestJS, Angular, React, Symfony, CodeIgniter, Express)
  • Full project analysis & environment doctor
  • Deterministic error analysis & likely locations
  • Smart template generator with overwrite protection
  • Interactive VS Code webview dashboard
  • API & database schema explorers
  • 100% passing automated test suite with fixtures
• [ ] V2: AI Intelligence Layer
  • Project contextual code generation
  • Explain complex stack traces using sanitized project snippets
  • Automated natural language refactoring suggestions
  • Semantic project queries ("Where is authentication implemented?")
• [ ] V3: Advanced Automation
  • Automated migration generation & relationship graph visualization
  • OpenAPI 3.1 specification generation
  • Multi-tenant shared workspace templates
• [ ] V4: Marketplace & Ecosystem
  • VS Code Marketplace publication
  • Community plugin extensions

License

This project is open-source software licensed under the MIT License.