Edsger

AI-powered software development CLI tool with comprehensive issue 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

🎯 Issue Analysis

• MCP Integration: Analyze issues using Model Context Protocol
• User Story Generation: Create comprehensive user stories for issues
• 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 issues
• Architecture Planning: Generate implementation roadmaps and technical details
• Integration Support: Works with MCP for structured design output

💻 Code Implementation

• Issue Implementation: Automatically implement issues 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 issues
• Test Execution: Execute test cases with detailed reporting
• Status Tracking: Monitor test results with pass/fail statistics

🚀 Workflow Management

• Continuous Processing: Monitor and process issues ready for development
• End-to-End Automation: Complete issue 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

Issue Analysis

# Analyze an issue and generate user stories/test cases
edsger --issue-analysis <issue-id>

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

Technical Design

# Generate technical design for an issue
edsger --technical-design <issue-id>

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

Code Implementation

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

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

Functional Testing

# Run functional tests for an issue
edsger --test <issue-id>

# Verbose test output
edsger --test <issue-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 (Issue Analysis, Technical Design, Implementation, Testing, Workflow)

• EDSGER_MCP_SERVER_URL: MCP server URL for issue 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 issue operations (analysis, design, implementation, testing)
• Playwright for functional testing (when using --test flag)

Releasing

Published from this directory using semantic-release, driven by Conventional Commit messages on main (fix: → patch, feat: → minor, feat!: / BREAKING CHANGE: → major).

cd packages/edsger
npm run release:preview   # dry-run, see the next version + notes
npm run release           # publish to npm + push the git tag

Important: the edsger-contract and edsger-tools versions referenced in package.json must already be on the npm registry before this CLI can be installed. Always run the Changesets flow for those two packages first — see RELEASING.md in the repo root for the full sequence.

License

ISC