NanoClaw Upstream Update Assistant
A guided runbook that merges upstream NanoClaw changes into your customized fork with backups, conflict previews, validation and breaking-change migrations.
Dev & CodingAdvanced★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026
What it does
Run /update-nanoclaw in Claude Code to walk a full upstream-sync procedure:
- Preflight: requires a clean working tree, adds the
upstreamremote if missing, and auto-detectsmainvsmaster. - Safety net: creates a timestamped backup branch and tag (
pre-update-<hash>-<timestamp>) before anything is touched. - Preview: uses
git log/git diffagainst the merge base and buckets changed files into Skills, hostsrc/,container/, build/config files and version pins. - Update paths: full merge (default), selective cherry-pick, rebase, or abort after viewing the changelog.
- Conflict handling: a
git merge --no-commit --no-ffdry run shows which files would conflict; the real merge opens only conflicted files and touches only conflict markers. - Validation and follow-up:
pnpm run build/pnpm test, container typecheck and image build/pull when needed, dependency install on lockfile changes,[BREAKING]CHANGELOG migrations, hand-off to/update-skills, an upgrade marker stamp, then rollback and service-restart instructions.
Token usage stays low by relying on git plumbing and opening only conflicted files.
Who it's for
- Operators running a customized NanoClaw fork.
- People who want to track upstream without a fresh reinstall and without losing local edits.
- Anyone who wants to see conflicts before merging and have a one-line rollback if the build breaks.
Examples
- Routine sync: run
/update-nanoclaw, review the upstream commit list and file buckets, confirm no conflicts, merge everything and let the skill runpnpm run build. - Hotfix only: pick two bug-fix commit hashes from the preview and cherry-pick just those, leaving unrelated upstream churn behind.
- Recovery: if the post-merge build fails, restore with the printed
git reset --hard pre-update-<hash>-<timestamp>.
· · · Install guide · · ·
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 clone the repo:
git clone https://github.com/nanocoai/nanoclaw.git - Create the skills directory if needed:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r nanoclaw/.claude/skills/update-nanoclaw ~/.claude/skills/ - If you already run a NanoClaw fork, you can simply use the
.claude/skills/update-nanoclawfolder inside that project instead. - Launch Claude Code from your NanoClaw project root.
- Before running, check
git statusand commit or stash any changes — the skill stops on a dirty working tree. - Type
/update-nanoclawand answer the prompts to choose merge, cherry-pick or rebase. - If something breaks, roll back with the backup tag shown in the summary:
git reset --hard <tag>.
View source on GitHub ↗License: MIT