Edsger

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

Features

$3

- 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

$3

- 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

$3

- 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

$3

- 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

$3

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

$3

- 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

$3

- 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

$3

- 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

``bash
npm install edsger
`

Usage

$3

`bash


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.

$3

`bash


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
`

$3

`bash


Analyze and refactor code in current directory

edsger --refactor

Verbose refactoring output

edsger --refactor --verbose
`

$3

`bash


Analyze a feature and generate user stories/test cases

edsger --feature-analysis

Verbose analysis output

edsger --feature-analysis --verbose
`

$3

`bash


Generate technical design for a feature

edsger --technical-design

Verbose design output

edsger --technical-design --verbose
`

$3

`bash


Implement feature code based on specifications

edsger --implement

Verbose implementation output

edsger --implement --verbose
`

$3

`bash


Run functional tests for a feature

edsger --test

Verbose test output

edsger --test --verbose
`

$3

`bash


Run continuous workflow processor

edsger --workflow

Run with verbose logging

edsger --workflow --verbose
`

$3

`bash


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.):

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

Environment Variables

$3

- 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)

$3

- 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:

`bash
#!/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