execute-code

Execute Code Skill

Execute JavaScript or Python code in a secure Hyperlight VM sandbox with full isolation.

This skill is standalone and shareable - it can be copied to any .claude/skills/ directory and works independently of the original repository.

Requirements

• Linux with KVM support (/dev/kvm)
• Python 3.8+
• Git (for cloning hyperlight-nanvix)
• Rust toolchain (installed automatically by setup script)

When to Use

Use this skill when:

• The user asks to run, execute, or test code
• You need to verify calculations or algorithm correctness
• You want to demonstrate code behavior with actual output

Standalone Installation

To use this skill in a new project or share it with others:

1. Copy the Skill

# Copy the entire execute-code directory to your project
cp -r /path/to/execute-code ~/.claude/skills/
# Or for project-specific use:
cp -r /path/to/execute-code /your/project/.claude/skills/

2. Run Setup

cd ~/.claude/skills/execute-code
./scripts/setup.sh

The setup script will:

• Create a virtual environment in .venv
• Install Rust nightly toolchain (if not present)
• Clone and build hyperlight-nanvix from source
• Configure everything for standalone use

3. Activate and Use

source .venv/bin/activate
python3 scripts/run.py --lang javascript --code 'console.log("Hello!");'

Quick Start

JavaScript

python3 scripts/run.py --lang javascript --code 'console.log(2 + 2);'

Python

python3 scripts/run.py --lang python --code 'print(2 + 2)'

Usage Notes

• JavaScript: Use console.log() to see output
• Python: Use print() to see output
• Code runs in VM-isolated sandbox (hyperlight-nanvix)
• The skill is self-contained with its own virtual environment

Examples

Calculate Fibonacci

python3 scripts/run.py --lang javascript --code '
const fib = n => n <= 1 ? n : fib(n-1) + fib(n-2);
for (let i = 0; i < 10; i++) console.log("fib(" + i + ") =", fib(i));
'