diffdev 0.2.1

A semi-autonomous framework for easily developing repo-wide changes

diffdev

diffdev is a command-line tool that helps you make repo-wide code changes using an AI assistant. It allows you to interactively select files, provide a prompt describing the desired changes, and apply the AI-generated modifications as a git patch.

Key Features

• File Selection: Use a TUI to select files to include in the context
• Context-Aware Changes: The AI assistant analyzes the selected files and your prompt to generate contextual changes
• Structured Patch Generation: Changes are returned as a git-style patch for easy application and review
• Revision Control Integration: Apply patches using git apply and rollback changes when needed
• Multiple AI Providers: Supports multiple LLM providers (Claude, DeepSeek) with flexible configuration
• Claude AI Assistant: Leverages the powerful Claude language model from Anthropic
• FrankenClaude Mode: Enhanced capabilities by combining multiple AI models
• Smart Context: Automatically updates context with modified files after changes
• Colored Output: Improved readability with color-coded responses
• Directory Content Copying: Quickly copy formatted directory trees and file contents to clipboard

Requirements

• Python 3.11 or 3.12 (untested for others)
• Git installed and available in PATH
• API key(s) for desired providers (Anthropic, DeepSeek)
• UNIX like OS

Installation

# Install using uvx
uvx diffdev

# Set your API key(s)
export ANTHROPIC_API_KEY="your-api-key-here"  # Required for Claude/FrankenClaude
export DEEPSEEK_API_KEY="your-api-key-here"   # Required for DeepSeek provider

Usage

1. Navigate to your git repository
2. Run diffdev
3. Use the TUI to select files for context:
   • Space: Toggle file/directory selection
   • Tab: Expand/collapse directories
   • Enter: Confirm selection
   • q: Quit selection
4. Enter your prompt describing the desired changes
5. Review and confirm the generated patch
6. Changes will automatically update the context for future prompts

Additional options:

• Use --frankenclaude to enable enhanced capabilities with multiple AI models
• Configure logging level for more detailed output

Commands

• select: Open file selector to update context
• undo: Rollback last applied changes
• redo: Reapply last rolled back changes
• exit: Exit diffdev

Directory Content Copying

To quickly copy a directory's tree structure and file contents:

# Copy current directory
diffdev --copydir

# Copy specific directory
diffdev --copydir /path/to/directory

This formats the output with line numbers and proper tree structure, respecting gitignore patterns.

Example

$ cd my-project
$ diffdev

Starting diffdev...
Select files to include in the context:
[ ] + src/
[ ] + tests/
[ ] README.md

# After selecting files and confirming...

Enter command or prompt: Add type hints to the User class methods

# AI will analyze files and generate changes
# Changes are applied as a git patch that can be rolled back if needed

Development

Contributions are welcome! Please feel free to submit a Pull Request.

TODO

• Fix bug in TUI file selector where directories with selected files don't show filled selector
• Add agents functionality (multiple LLMs solving same problem with result aggregation)
• Support OpenAI API compatible endpoints (with port configuration)
• Allow specifying model name to use
• Add general model configuration file
• Add flag to specify API key
• Add retry/refix functionality for failed diffs
• Add retry/fix for invalid JSON LLM responses
• Enhance TUI with more color options
• Improve code modularization
• Add automatic file searching capability
• Add tool support for fetching up-to-date documentation
• Add navigation system for reviewing changes in current session
• Add reference system for previous changes in current session