repren Files

What's Changed in 2.0.0

This is a major release of repren with new features for AI agents, backup management, enhanced documentation, and modernized tooling.

New Features for AI Agents

Claude Code Skill Integration

repren is now fully optimized for use by AI coding agents, especially Claude Code:

• Packaged as a Claude Code skill with --install-skill option for easy installation
• Self-documenting with --docs flag for full formatted documentation in terminal
• --skill flag to output agent skill instructions
• --agent-base option to configure skill installation directory
• Machine-parseable JSON output mode (--format=json) for automation

Enhanced CLI Documentation

• Added markdown-to-ANSI renderer for beautiful, formatted help text
• Reorganized help options for clearer UX (--help for usage, --docs for full docs)
• Fixed documentation issues in CLI help output
• All docs now use single source of truth
• Updated Alternatives comparison with modern tools

Backup Management

Added three new options for managing backup files:

• --undo: Restore files from their .orig backups
• --clean-backups: Remove all backup files after confirming changes are correct
• --backup-suffix: Configure custom backup file extensions (default: .orig)

JSON Output Format

Added --format=json option for machine-parseable output, making repren easier to integrate with scripts, agents, and automation tools.

Developer Experience Improvements

Migration to uv

Migrated from Poetry to uv using the simple-modern-uv template:

• Faster dependency resolution and installation
• Simpler developer workflows
• Better compatibility with modern Python tooling

Improved Testing

• Enhanced golden tests for cross-platform reliability (Mac and Linux)
• Added test coverage analysis with pytest-cov
• Fixed CI determinism issues
• Comprehensive test coverage for backup management and core features

Bug Fixes

• Fixed --at-once flag functionality
• Fixed golden tests to work reliably across Mac and Linux
• Fixed stdin/stdout test output ordering for CI
• Fixed dynamic versioning to recognize unprefixed tags
• Fixed Python 3.10-3.11 compatibility for override decorator

Code Quality

• Modernized CLI patterns following Python best practices
• Modernized code style and removed legacy lint suppressions
• Updated to support Python 3.10-3.14
• Security: Bumped jinja2 from 3.1.4 to 3.1.5

Breaking Changes

None - this release maintains backward compatibility with 1.x versions.

Full Changelog

https://github.com/jlevy/repren/compare/1.0.2...2.0.0

---

Install with: uvx repren@latest --help