Edsger

AI-powered software development CLI tool with comprehensive feature management, code review, and testing capabilities using Claude Code SDK and MCP integration.

Features

🚀 Project Initialization

• Automated Documentation: Uses Claude Code SDK to analyze your codebase and generate comprehensive documentation
• Phase Optimization: Provides project context to all phases for better AI understanding
• Smart Analysis: Automatically discovers tech stack, architecture, coding patterns, and conventions
• One-Command Setup: Quick initialization with edsger --init - no manual documentation needed

🔍 Code Review

• AI-Powered Reviews: Uses Claude Code SDK for intelligent code analysis
• Git Integration: Reviews uncommitted or staged changes automatically
• Configurable: Customize patterns, exclusions, and review severity
• Hook-Friendly: Designed for pre-commit hooks and CI/CD automation
• Detailed Output: Clear feedback with blocking/warning/passing results

🔧 Code Refactoring

• Intelligent Analysis: AI-powered code quality and refactoring analysis
• Pattern Detection: Identifies code smells, duplication, and technical debt
• Improvement Suggestions: Provides prioritized recommendations for code improvement
• Interactive Mode: Ask for confirmation before applying refactoring changes

🎯 Feature Analysis

• MCP Integration: Analyze features using Model Context Protocol
• User Story Generation: Create comprehensive user stories for features
• Test Case Creation: Generate detailed test cases with criticality levels
• Deduplication: Avoid creating similar existing user stories and test cases
• Real-time Streaming: Live analysis feedback with Claude Code SDK

🎨 Technical Design

• Design Generation: Create technical specifications for features
• Architecture Planning: Generate implementation roadmaps and technical details
• Integration Support: Works with MCP for structured design output

💻 Code Implementation

• Feature Implementation: Automatically implement features based on specifications
• Branch Management: Creates feature branches and manages git workflow
• Code Generation: AI-powered code writing with proper git integration

🎭 Functional Testing

• Automated Testing: Run Playwright-based functional tests for features
• Test Execution: Execute test cases with detailed reporting
• Status Tracking: Monitor test results with pass/fail statistics

🚀 Workflow Management

• Continuous Processing: Monitor and process features ready for development
• End-to-End Automation: Complete feature lifecycle from analysis to testing
• Real-time Monitoring: Live workflow processing with statistics and graceful shutdown

Installation

npm install edsger

Usage

Project Initialization

# Initialize .edsger directory - AI automatically generates documentation
edsger --init

# Verbose output to see the analysis process
edsger --init --verbose

The init command uses Claude Code SDK to automatically:

1. Analyze your codebase structure and files
2. Discover technologies, frameworks, and dependencies
3. Identify architectural patterns and design decisions
4. Extract coding conventions and standards
5. Generate comprehensive documentation in .edsger/ directory

Generated documentation files:

• project-overview.md - Project description, goals, and core features
• tech-stack.md - Technologies, frameworks, and tools used
• architecture.md - System architecture and design decisions
• coding-guidelines.md - Coding standards and conventions
• development-setup.md - Development environment setup instructions

These files provide rich context to all edsger phases for better code generation, analysis, and implementation. You can edit them manually to refine or add details.

Code Review

# Review all uncommitted changes
edsger --review

# Review only staged changes
edsger --review --staged

# Review specific file patterns
edsger --review --files "**/*.ts" "**/*.js"

# Verbose output
edsger --review --verbose

Code Refactoring

# Analyze and refactor code in current directory
edsger --refactor

# Verbose refactoring output
edsger --refactor --verbose

Feature Analysis

# Analyze a feature and generate user stories/test cases
edsger --feature-analysis <feature-id>

# Verbose analysis output
edsger --feature-analysis <feature-id> --verbose

Technical Design

# Generate technical design for a feature
edsger --technical-design <feature-id>

# Verbose design output
edsger --technical-design <feature-id> --verbose

Code Implementation

# Implement feature code based on specifications
edsger --implement <feature-id>

# Verbose implementation output
edsger --implement <feature-id> --verbose

Functional Testing

# Run functional tests for a feature
edsger --test <feature-id>

# Verbose test output
edsger --test <feature-id> --verbose

Workflow Management

# Run continuous workflow processor
edsger --workflow

# Run with verbose logging
edsger --workflow --verbose

Default Behavior

# Auto-detects mode based on environment:
# - If EDSGER_PRODUCT_ID and EDSGER_MCP_TOKEN are set: workflow mode
# - Otherwise: code review mode
edsger

Configuration

Create a configuration file (.edsgerrc.json, edsger.config.js, etc.):

{
  "patterns": ["**/*.js", "**/*.ts"],
  "exclude": ["node_modules/**", "*.test.js"],
  "severity": "error",
  "maxFiles": 100,
  "claude": {
    "model": "sonnet",
    "timeout": 120000
  }
}

Environment Variables

Required for Advanced Features (Feature Analysis, Technical Design, Implementation, Testing, Workflow)

• EDSGER_MCP_SERVER_URL: MCP server URL for feature operations
• EDSGER_MCP_TOKEN: Required authentication token for MCP server
• EDSGER_PRODUCT_ID: Product ID for workflow management (optional for workflow mode)

Configuration Options

• patterns: File patterns to include (default: common code files)
• exclude: File patterns to exclude (default: tests, builds, node_modules)
• severity: "error" (exit 1 on issues) or "warning" (exit 0 always)
• maxFiles: Maximum files to review in one run
• claude.model: Claude model to use (sonnet, opus, etc.)
• claude.timeout: Timeout in milliseconds

Git Hooks Integration

Add to your .git/hooks/pre-commit:

#!/bin/sh
npx edsger --review --staged

Requirements

• Node.js >= 18.0.0
• @anthropic-ai/claude-code SDK
• MCP server for advanced feature operations (analysis, design, implementation, testing)
• Playwright for functional testing (when using --test flag)

License

ISC