메뉴
Wax deployment orchestration skill. Use when releasing new versions of Wax across npm, Homebrew, OpenClaw, OpenCode, or Claude Code channels. Covers version bumping, congruency validation, binary building, staged publishing, and rollback procedures.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/christopherkarani/Wax --skill wax-deploy명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Swift framework guidance for Wax on-device memory/RAG. Use when writing Swift code with the public Memory facade, embedding providers, retrieval modes, or hybrid search. For agent operators using the Wax MCP server tools, use the separate wax-mcp skill instead.
Maintain the Wax memory store used by the Hermes wax-memory provider.
Operator playbook for the Wax MCP memory server. Use whenever Wax MCP tools are available (remember, recall, search, handoff, session_start/end, structured memory), when installing or configuring waxmcp, or when an agent should keep durable cross-session memory. Prefer this skill over the Swift framework skill unless the task is writing Wax Swift code.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | wax-deploy |
| description | Wax deployment orchestration skill. Use when releasing new versions of Wax across npm, Homebrew, OpenClaw, OpenCode, or Claude Code channels. Covers version bumping, congruency validation, binary building, staged publishing, and rollback procedures. |
Wax deploys to 5 channels from a single source of truth. This skill ensures predictable, resilient, and congruent releases across all channels.
| Channel | Artifact | Location |
|---|---|---|
| npm | waxmcp package | Resources/npm/waxmcp/ |
| Homebrew | wax.rb formula | Resources/npm/waxmcp/homebrew-wax/ |
| OpenClaw | @wax/openclaw-wax-memory plugin | Resources/openclaw/wax-memory-plugin/ |
| OpenCode | .pi extension + agents | .pi/extensions/wax-agents/ |
| Claude Code | MCP server registration | wax-cli mcp install |
# Full pipeline: bump → build → validate → commit message
scripts/release-all.sh 0.1.23
# Then commit, tag, and publish:
git add -A && git commit -m "release: waxmcp v0.1.23"
git tag waxmcp-v0.1.23 && git push origin main --tags
scripts/publish-all.sh --tag next
scripts/validate-congruency.sh
# or JSON output for CI:
scripts/validate-congruency.sh --json
scripts/release-all.sh 0.1.23 --dry-run
scripts/publish-all.sh --tag next --dry-run
scripts/bump-version.sh atomically updates all 7 version surfaces:
Resources/npm/waxmcp/package.jsonSources/WaxMCPServer/main.swiftResources/openclaw/wax-memory-plugin/package.json (version)Resources/openclaw/wax-memory-plugin/package.json (waxmcp dependency)Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb (URL)Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb (SHA256).pi/extensions/wax-agents/package.jsonscripts/bump-version.sh 0.1.23 # exact version
scripts/bump-version.sh patch # or minor/major
scripts/bump-version.sh 0.1.23 --dry-run
scripts/release-all.sh builds darwin-arm64 and darwin-x64 binaries:
scripts/release-all.sh 0.1.23
# Skip build if binaries already exist:
scripts/release-all.sh 0.1.23 --skip-build
scripts/validate-congruency.sh asserts all surfaces match:
scripts/validate-congruency.sh # human-readable
scripts/validate-congruency.sh --json # machine-readable
scripts/validate-congruency.sh --quiet # CI-friendly (exit 0/1 only)
scripts/publish-all.sh supports canary → soak → promote workflow:
# Publish to canary
scripts/publish-all.sh --tag next
# After soak period, promote to latest
scripts/publish-all.sh --promote
# Preview without publishing
scripts/publish-all.sh --tag next --dry-run
All channels must share the same version. The canonical source is Resources/npm/waxmcp/package.json.
| Symptom | Cause | Fix |
|---|---|---|
| openclaw ≠ npm | Plugin not bumped after waxmcp release | scripts/bump-version.sh $(npm version) |
| homebrew ≠ npm | Formula manually edited, not via script | scripts/bump-version.sh recomputes URL + SHA |
| opencode ≠ npm | Extension version never tracked | scripts/bump-version.sh aligns it |
Add to .github/workflows/release-waxmcp.yml before publish:
- name: Validate version congruency
run: scripts/validate-congruency.sh --quiet
git checkout -- Resources/npm/waxmcp/package.json \
Sources/WaxMCPServer/main.swift \
Resources/openclaw/wax-memory-plugin/package.json \
.pi/extensions/wax-agents/package.json \
Resources/npm/waxmcp/homebrew-wax/Formula/wax.rb
# Unpublish within 24 hours
npm unpublish waxmcp@0.1.23
npm unpublish @wax/openclaw-wax-memory@0.1.23
# Republish previous version as latest
npm dist-tag add waxmcp@0.1.22 latest
npm dist-tag add @wax/openclaw-wax-memory@0.1.22 latest
Commit or stash changes before running release-all.sh:
git stash
scripts/release-all.sh 0.1.23
git stash pop
Or use --allow-dirty (not recommended for production releases).
Run the bump script to align all surfaces:
scripts/bump-version.sh $(node -p "require('./Resources/npm/waxmcp/package.json').version")
Version already published. Check:
npm view waxmcp versions --json | tail -5
The SHA in the formula is computed from local git archive. After pushing the tag, verify:
curl -sL https://github.com/christopherkarani/Wax/archive/refs/tags/waxmcp-v0.1.23.tar.gz | shasum -a 256
If different, update the formula manually or re-run bump-version.sh after the tag is pushed.
bump-version.sh updates all surfaces in one invocation--dry-run for safe previewnext tag for canary, latest for productionset -euo pipefail on all scripts; validation gates before publishResources/scripts/ helpers