void-box: Skill for Claude Code

Runs examples/smoke/smoke.yaml — the agent replies with "vm-ok 2+2=4". No tool use required; any model that generates text will pass. Success is success: true with output containing vm-ok.

All commands run from the repository root.

Usage: /test-vm [ollama [model] | claude | claude-personal]

• ollama [model] — local Ollama (default model: phi4-mini)
• claude — Anthropic API key (ANTHROPIC_API_KEY must be set)
• claude-personal — personal Claude account (macOS: extracted from Keychain; Linux: staged from ~/.claude/)
• no argument — defaults to ollama phi4-mini

Recommended Ollama models (2–4 GB RAM, reliable with claude-code): phi4-mini, gemma3:4b, llama3.2:3b. Avoid *-coder variants — they don't follow the agentic protocol well.

---

Step 1 — Prerequisites

Kernel

Check for an existing kernel file. macOS needs an uncompressed kernel (vmlinux-*); Linux can use the host kernel (vmlinuz-*):

ls target/vmlinux-arm64 2>/dev/null \
  || ls target/vmlinux-amd64 2>/dev/null \
  || ls /boot/vmlinuz-$(uname -r) 2>/dev/null \
  || echo "MISSING"

If missing, download it (the script caches the result in target/):

scripts/download_kernel.sh

After downloading, run the check again to confirm and record the path — it is needed in Step 4.

Rootfs

ls target/void-box-rootfs.cpio.gz 2>/dev/null || echo "MISSING"

If missing, build it (auto-detects the claude binary on PATH or ~/.local/bin/claude):

scripts/build_claude_rootfs.sh

Run the check again to confirm. If it still fails, tell the user to set CLAUDE_BIN=/path/to/claude and retry.

---

Step 2 — Build and sign

cargo build --release --bin voidbox

macOS only — Apple Virtualization.framework requires the entitlement:

codesign --force --sign - --entitlements voidbox.entitlements target/release/voidbox

---

Step 3 — Provider setup

Ollama

Check Ollama is installed:

which ollama || echo "NOT INSTALLED"