pyx Executor

Use pyx for safe Python execution. Default: MANIFEST_IO mode.

Read-First: Environment (Mandatory)

If you need any of the following, you MUST read references/environment.md first:

• •Which Python packages are installed for pyx
• •OS details
• •Shell type/path and shell syntax notes

Do NOT do trial-and-error checks (e.g. guessing imports, probing commands). Prefer the generated environment document as the source of truth.

Note: pyx info can be slow. Prefer reading references/environment.md first.

Current Environment

• •OS: Windows (AMD64)
• •Shell: powershell
• •pyx Python: 3.12.12
• •pyx version: 0.1.0

Depends On (Soft)

Load these skills alongside pyx:

• •manifest - MANIFEST_IO contract and workflow
• •learn - skill extraction workflow and summary reference

MANIFEST_IO (Default)

pyx assumes MANIFEST_IO by default:

• •Read inputs from JSON files
• •Write outputs to files + a manifest
• •Print a short stdout summary (paths + sizes)
• •Check sizes before reading outputs into context

See the manifest skill for the full spec.

Non-Strict Mode (Opt-out)

Use only when user explicitly says:

• •"no strict mode"
• •"simple mode"

pyx run --file "temp/task.py"

Golden Rule

NEVER paste code inline to shell. Always write to file first:

# ❌ WRONG
pyx run --code "import os; print(os.listdir())"

# ✅ CORRECT
pyx ensure-temp --dir "temp"
# Write code to: temp/list_files.py
pyx run --file "temp/list_files.py"

Quick Reference

References

pyx-specific references:

• •CLI Commands - Full CLI help output
• •Environment Info - Paths, packages, shell info

Common use-cases:

• •Use Case 1: Incident Debugging
• •Use Case 2: Project vs Global Skills
• •Use Case 3: Rewrite Migration Baseline