What problem does it solve?
NanoClaw users who fork the repository to add custom configurations, modify core source code, adjust agent personas, or install additional skills face painful, time-consuming merge conflicts when upstream releases updates, as standard git merge cannot cleanly reconcile custom changes with upstream refactors.
Core Features & Use Cases
- Intent-Based Migration Guide Generation: Extracts all user customizations into a structured markdown guide that captures both the intended outcome and exact implementation details (code snippets, API calls, config values) needed to reproduce changes on a clean codebase.
- Tiered Workflow Support: Adapts to migration complexity, from lightweight single-command updates for small changes to full multi-phase migration with sub-agent exploration for heavily customized forks.
- Safe, Isolated Upgrade Process: Uses git worktrees to validate changes on a separate branch before affecting the live install, with automatic backup tags and rollback points to prevent data loss.
- Use Case: A classroom administrator who customized their NanoClaw fork with custom Telegram integrations, modified student role permissions, and added a custom grading skill can upgrade to the latest upstream version in minutes without manually resolving dozens of merge conflicts.
Quick Start
Use the migrate-nanoclaw skill to extract your NanoClaw fork customizations into a migration guide and upgrade to the latest upstream version without any merge conflicts.