How do I install the Aio Patch Extract skill?

Run npx skillmds@latest add aiocean/aio-patch-extract in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Aio Patch Extract skill do?

Extract Claude Code's cli.js + native .node modules from an installed claude binary (or a binary you pass as positional arg). Output lands in dist/ /. Required before aio-patch-compile. Default arch detected from host; ARCH env var overrides for cross-arch extraction. It is listed under Coding & Dev Tools on SkillMD.

Is Aio Patch Extract safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Aio Patch Extract?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Aio Patch Extract free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Aio Patch Extract?

aiocean (@aiocean) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Aio Patch Extract by aiocean — Agent Skill

Name: Aio Patch Extract
Author: aiocean

Aio Patch Extract

Extract Claude Code's cli.js + native .node modules from an installed claude binary (or a binary you pass as positional arg). Output lands in dist/<arch>/. Required before aio-patch-compile. Default arch detected from host; ARCH env var overrides for cross-arch extraction.

aiocean 2293fa7 2 files · 2.3 KB Updated Sep 17, 2026

File contents

aio-patch-extract — extract cli.js + native modules from a claude binary

Goal

Materialize dist/<arch>/cli.js + dist/<arch>/native/*.node from an installed claude binary so subsequent aio-patch-compile can apply patches and recompile.

Usage

/aio-claude-toolkit:aio-patch-extract                          # download latest claude from npm for HOST arch
/aio-claude-toolkit:aio-patch-extract /path/to/claude          # extract from a local binary (positional arg)
ARCH=linux-arm64 /aio-claude-toolkit:aio-patch-extract         # cross-arch (downloads target-arch npm pkg)
CLAUDE_VERSION=2.1.150 /aio-claude-toolkit:aio-patch-extract   # pin a specific upstream version

Argument and env precedence (tools/extract.sh):

Positional arg 1: path to a claude binary you already have
Otherwise: claude-src/claude at project root if present
Otherwise: download @anthropic-ai/claude-code-<arch> from npm (CLAUDE_VERSION env pins, default: latest)
ARCH env: override host-detected platform (cross-arch). Supported: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64.

Requires

Walk-up must find a scaffolded project (tools/pipeline/patch_cli.py exists above CWD)
python3 (for extract_cli.py + extract_native_modules.py)
npm (only if downloading a fresh claude — passing a positional binary path skips this)

Implementation

The skill body invokes ${CLAUDE_PLUGIN_ROOT}/skills/aio-patch-extract/scripts/extract.sh "$@".

It:

Walks up from CWD to find the project root
cd to project root
Exec ./tools/extract.sh "$@" (pass-through args, honors ARCH env)

tools/extract.sh handles binary resolution, npm download fallback, arch detection (or ARCH override after sync patch), and pipeline invocation.

---name: aio-patch-extractdescription: Extract Claude Code's cli.js + native .node modules from an installed claude binary (or a binary you pass as positional arg). Output lands in dist/<arch>/. Required before aio-patch-compile. Default arch detected from host; ARCH env var overrides for cross-arch extraction.---# aio-patch-extract — extract cli.js + native modules from a claude binary## GoalMaterialize `dist/<arch>/cli.js` + `dist/<arch>/native/*.node` from an installed claude binary so subsequent `aio-patch-compile` can apply patches and recompile.## Usage```/aio-claude-toolkit:aio-patch-extract # download latest claude from npm for HOST arch/aio-claude-toolkit:aio-patch-extract /path/to/claude # extract from a local binary (positional arg)ARCH=linux-arm64 /aio-claude-toolkit:aio-patch-extract # cross-arch (downloads target-arch npm pkg)CLAUDE_VERSION=2.1.150 /aio-claude-toolkit:aio-patch-extract # pin a specific upstream version```Argument and env precedence (`tools/extract.sh`):- Positional arg 1: path to a claude binary you already have- Otherwise: `claude-src/claude` at project root if present- Otherwise: download `@anthropic-ai/claude-code-<arch>` from npm (CLAUDE_VERSION env pins, default: latest)- `ARCH` env: override host-detected platform (cross-arch). Supported: `darwin-arm64`, `darwin-amd64`, `linux-arm64`, `linux-amd64`.## Requires- Walk-up must find a scaffolded project (`tools/pipeline/patch_cli.py` exists above CWD)- `python3` (for `extract_cli.py` + `extract_native_modules.py`)- `npm` (only if downloading a fresh claude — passing a positional binary path skips this)## ImplementationThe skill body invokes `${CLAUDE_PLUGIN_ROOT}/skills/aio-patch-extract/scripts/extract.sh "$@"`.It:1. Walks up from CWD to find the project root2. `cd` to project root3. Exec `./tools/extract.sh "$@"` (pass-through args, honors `ARCH` env)`tools/extract.sh` handles binary resolution, npm download fallback, arch detection (or `ARCH` override after sync patch), and pipeline invocation.

Frequently asked questions