NanoClaw Upstream Update Assistant
Safely merges upstream NanoClaw changes into your customized fork with backups, conflict preview, and selective cherry-picking.
Dev & CodingIntermediate★ 30,471⑂ 12,865AI score 8/10Last updated: Aug 9, 2026
What it does
- Preflight: verifies a clean working tree (
git status --porcelain), adds theupstreamremote if missing, and detects whether the upstream branch ismainormaster. - Safety net: creates a timestamped backup branch and tag (
pre-update-<hash>-<timestamp>) before touching anything. - Preview: lists upstream commits and changed files against the merge base, bucketed into Skills, host source (
src/), container, build/config files, and version pins. - Update paths: full merge (default), selective cherry-pick, rebase, or abort after viewing the changelog.
- Conflict dry-run: uses
git merge --no-commit --no-ffto list conflicting files before you commit to anything. - Validation & follow-through: installs deps when lockfiles move, runs
pnpm run buildandpnpm test, handles container typecheck/image build-or-pull, scans CHANGELOG for[BREAKING]entries and offers the matching migrations, then prints a summary with rollback and service-restart commands. - Token-frugal: opens only conflicted files, relying on git output for everything else.
Who it's for
- Anyone running a customized NanoClaw fork who still wants upstream fixes and features.
- Maintainers who want to avoid a fresh reinstall on every upstream release.
- Users who want git merge/cherry-pick/rebase driven for them with a guaranteed rollback point.
Examples
- Run
/update-nanoclaw, skim the upstream commit list, choose "full update", resolve two conflicts, and let it build and test automatically. - Need only one urgent upstream bugfix: pick selective mode and cherry-pick just that commit hash.
- After the merge, a
[BREAKING]CHANGELOG entry appears — the skill reads the migration guide and offers to run the referenced skill (e.g./add-whatsapp); if anything breaks, roll back withgit reset --hard pre-update-....
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/update-nanoclaw/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the .claude/skills/update-nanoclaw folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/update-nanoclaw/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/update-nanoclaw ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and create the skills directory:
mkdir -p ~/.claude/skills - Clone the NanoClaw repo to a temporary spot:
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw - Copy the skill folder:
cp -r /tmp/nanoclaw/.claude/skills/update-nanoclaw ~/.claude/skills/- If you already run NanoClaw, this skill ships inside your project at
.claude/skills/update-nanoclaw, so no copy is needed.
- If you already run NanoClaw, this skill ships inside your project at
- Make sure
gitandpnpmare installed (container steps may additionally needbunand image build tooling). - Commit or stash local changes so the working tree is clean:
git status - From your NanoClaw project root in Claude Code, run
/update-nanoclawand choose an update path at the preview prompt. - If something goes wrong, roll back with the backup tag printed at the end:
git reset --hard pre-update-<hash>-<timestamp>
View source on GitHub ↗License: MIT