yx-sandbox

name: yx-sandbox description: Use when running yx commands that create, modify, or delete yaks outside of real project work — provides an isolated temp environment

yx Sandbox

Use a sandbox whenever you need to run yx commands that would pollute the project's real yak list — exploratory testing, UX reviews, demos, experiments, etc.

Setup

Create a temp directory and capture its literal path:

mktemp -d
# Output: /tmp/tmp.xYz123AbC  ← capture this literal path

Usage

Prefix every yx command with the env vars using the literal path from above:

cd /tmp/tmp.xYz123AbC && YX_SKIP_GIT_CHECKS=1 yx <command>

• cd /tmp/tmp.xYz123AbC enters the temp sandbox directory
• YX_SKIP_GIT_CHECKS=1 avoids git setup requirements in temp dirs
• yx will use .yaks in the current directory when git checks are skipped
• Never run bare yx without YX_SKIP_GIT_CHECKS=1 during sandbox work

Note: Shell variables don't persist between Bash tool calls. Always use the literal path, not a variable like $SANDBOX.

Cleanup

rm -rf /tmp/tmp.xYz123AbC

Common Mistakes