Pyx

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