claude-multi 0.5.5 → 0.5.6

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.6] - 2026-05-23
+
+### Added
+- **`robots.txt` route** (`src/web/pages/robots.txt.ts`): serves sitemap reference and user-agent directives for the docs site
+
+### Changed
+- **Runtime-agnostic launcher** (`bin/claude-multi.js`): polyglot bin entry is simultaneously valid POSIX sh and ESM JavaScript
+  - On Linux/macOS: shell shebang detects bun/node/deno and execs the correct runtime
+  - On Windows + bun global install: bun's `.exe` shim reads the `.js` extension and runs directly as ESM — no `/bin/sh` lookup required
+  - On Windows + npm install: npm's `.cmd` shim calls `node` on the `.js` file
+  - Shebang changed to `#!/usr/bin/env bun` so bun's Windows shim can resolve itself in `PATH`
+
+### CI
+- Add cross-platform install verification workflow covering bun, node, and deno on Linux, Windows, and macOS
+- Separate build into its own job; test jobs download the artifact instead of rebuilding
+- Publish workflow now includes version bump step and enhanced post-publish verification
+- Add `ci:test-install` script to trigger the install-verification workflow from local
+
 ## [0.5.5] - 2026-05-22
 
 ### Added

package/bin/claude-multi.cmd

@@ -0,0 +1,26 @@
+@echo off
+setlocal
+:: Resolve package root (bin\ -> ..\)
+set "_cli=%~dp0..\dist\cli.js"
+
+where bun >nul 2>&1
+if not errorlevel 1 (
+  bun "%_cli%" %*
+  exit /b %errorlevel%
+)
+
+where node >nul 2>&1
+if not errorlevel 1 (
+  node "%_cli%" %*
+  exit /b %errorlevel%
+)
+
+where deno >nul 2>&1
+if not errorlevel 1 (
+  deno run -A "%_cli%" %*
+  exit /b %errorlevel%
+)
+
+echo claude-multi: no JavaScript runtime found (install bun, node, or deno) 1>&2
+exit /b 1
+endlocal

package/bin/claude-multi.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env sh
+SCRIPT="$0"
+while [ -L "$SCRIPT" ]; do
+  LINK=$(readlink "$SCRIPT")
+  case "$LINK" in
+    /*) SCRIPT="$LINK" ;;
+    *)  SCRIPT="$(dirname "$SCRIPT")/$LINK" ;;
+  esac
+done
+DIR=$(cd "$(dirname "$SCRIPT")" && pwd)
+CLI="$DIR/../dist/cli.js"
+
+if command -v bun >/dev/null 2>&1; then
+  exec bun "$CLI" "$@"
+elif command -v node >/dev/null 2>&1; then
+  exec node "$CLI" "$@"
+elif command -v deno >/dev/null 2>&1; then
+  exec deno run -A "$CLI" "$@"
+else
+  echo "claude-multi: no JavaScript runtime found (install bun, node, or deno)" >&2
+  exit 1
+fi

package/dist/cli.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
@@ -8619,24 +8618,11 @@ function getClaudePath() {
 }
 function generateWrapperScript(options) {
   const claudePath = getClaudePath();
-  return `#!/usr/bin/env node
-
-// Claude Multi - Wrapper for ${options.name}
-// Generated by claude-multi
-
-import { spawn } from 'child_process';
-
-process.env.CLAUDE_CONFIG_DIR = "${options.configDir}";
-
-// Execute the original Claude Code CLI with all arguments
-const claude = spawn("${claudePath}", process.argv.slice(2), {
-  stdio: 'inherit',
-  env: process.env
-});
-
-claude.on('exit', (code) => {
-  process.exit(code || 0);
-});
+  return `#!/bin/sh
+# Claude Multi - Wrapper for ${options.name}
+# Generated by claude-multi
+export CLAUDE_CONFIG_DIR="${options.configDir}"
+exec "${claudePath}" "$@"
 `;
 }
 function generateWindowsWrapperScript(options) {

package/package.json

@@ -1,23 +1,29 @@
 {
   "name": "claude-multi",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "Manage multiple Claude Code instances with different aliases and configurations",
   "type": "module",
   "bin": {
-    "claude-multi": "./dist/cli.js"
+    "claude-multi": "./bin/claude-multi.js"
   },
+  "files": [
+    "bin/",
+    "dist/cli.js",
+    "CHANGELOG.md"
+  ],
   "scripts": {
-    "build": "bun build src/cli.ts --outdir dist --target node --format esm && chmod +x dist/cli.js",
+    "build": "bun build src/cli.ts --outdir dist --target node --format esm && chmod +x bin/claude-multi.js",
     "dev": "bun run src/cli.ts",
     "test": "bun test",
     "prepublishOnly": "bun run build",
-    "test:binary": "./dist/cli.js",
+    "test:binary": "./bin/claude-multi.js",
     "install:global": "bun link",
     "docs:dev": "astro dev",
     "docs:build": "astro build",
     "docs:preview": "astro preview",
     "ci:docs:deploy": "gh workflow run deploy-docs.yml",
-    "ci:publish": "gh workflow run publish.yml -f version=$(node -p \"require('./package.json').version\")"
+    "ci:publish": "gh workflow run publish.yml -f version=$(node -p \"require('./package.json').version\")",
+    "ci:test-install": "gh workflow run test-install.yml"
   },
   "keywords": [
     "claude",
@@ -64,6 +70,7 @@
     "three": "^0.184.0"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18.0.0",
+    "bun": ">=1.0.0"
   }
 }

package/.agents/skills/three/SKILL.md

@@ -1,106 +0,0 @@
----
-name: three
-description: Three.js and WebGL adapter patterns for HyperFrames. Use when creating deterministic Three.js scenes, WebGL canvas layers, AnimationMixer timelines, camera motion, shader-driven visuals, or canvas renders that respond to HyperFrames hf-seek events.
----
-
-# Three.js for HyperFrames
-
-HyperFrames supports Three.js through its `three` runtime adapter. The adapter does not own your scene. It publishes HyperFrames time and dispatches a seek event so your composition can render the exact frame.
-
-## Contract
-
-- Create the scene, camera, renderer, materials, and assets synchronously when possible.
-- Render from HyperFrames time, not wall-clock time.
-- Listen for the `hf-seek` event and render exactly that time.
-- Load models, textures, and HDRIs before render-critical seeking. Do not fetch them at seek time.
-- Avoid `requestAnimationFrame` or `renderer.setAnimationLoop` as the source of truth for render-critical motion.
-
-The adapter sets `window.__hfThreeTime` and dispatches `new CustomEvent("hf-seek", { detail: { time } })` on each seek.
-
-## Basic Pattern
-
-```html
-<canvas id="three-layer"></canvas>
-<script type="module">
-  import * as THREE from "https://cdn.jsdelivr.net/npm/three@0.181.2/+esm";
-
-  const canvas = document.getElementById("three-layer");
-  const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
-  // Match these to your composition's frame size.
-  renderer.setSize(1920, 1080, false);
-  renderer.setPixelRatio(1);
-
-  const scene = new THREE.Scene();
-  const camera = new THREE.PerspectiveCamera(35, 1920 / 1080, 0.1, 100);
-  camera.position.set(0, 0, 6);
-
-  const mesh = new THREE.Mesh(
-    new THREE.IcosahedronGeometry(1.4, 4),
-    new THREE.MeshStandardMaterial({ color: 0x64d2ff, roughness: 0.38 }),
-  );
-  scene.add(mesh);
-  scene.add(new THREE.HemisphereLight(0xffffff, 0x223344, 2));
-
-  function renderAt(time) {
-    mesh.rotation.y = time * 0.7;
-    mesh.rotation.x = Math.sin(time * 0.6) * 0.16;
-    renderer.render(scene, camera);
-  }
-
-  window.addEventListener("hf-seek", (event) => {
-    renderAt(event.detail.time);
-  });
-
-  renderAt(window.__hfThreeTime || 0);
-</script>
-```
-
-```css
-#three-layer {
-  width: 100%;
-  height: 100%;
-  display: block;
-}
-```
-
-## AnimationMixer Pattern
-
-For GLTF or authored clip animation, seek the mixer directly:
-
-```js
-function renderAt(time) {
-  mixer.setTime(time);
-  renderer.render(scene, camera);
-}
-```
-
-If several mixers exist, seek all of them from the same `time`.
-
-## Good Uses
-
-- Deterministic 3D objects, product spins, particles with seeded data, and shader plates.
-- Camera moves derived from `time`.
-- GLTF animation clips when assets are local and loaded before validation completes.
-
-## Avoid
-
-- Using `Date.now()`, `performance.now()`, or clock deltas to update scene state.
-- Leaving render-critical work inside a free-running animation loop.
-- Loading remote models or textures at render time.
-- Device-pixel-ratio dependent output. Pin renderer size and pixel ratio for video renders.
-- Post-processing passes that depend on previous frame history unless you can reconstruct state from time.
-
-## Validation
-
-After editing a Three.js composition:
-
-```bash
-npx hyperframes lint
-npx hyperframes validate
-```
-
-## Credits And References
-
-- HyperFrames adapter source: `packages/core/src/runtime/adapters/three.ts`.
-- Three.js `WebGLRenderer` docs: https://threejs.org/docs/pages/WebGLRenderer.html
-- Three.js `AnimationMixer.setTime()` docs: https://threejs.org/docs/pages/AnimationMixer.html