the-agency-ai/the-agency/sandbox-activate

Sandbox Activate

Wire up a sandbox item so Claude Code discovers and uses it.

Arguments

$ARGUMENTS is <name> — the item name (without extension).

Steps

1. Detect engineer from usr/*/ directories.

1. Find the item by searching usr/<engineer>/ for files matching <name>:

• usr/<engineer>/claude/commands/<name>.md → command
• usr/<engineer>/agency/hooks/<name>.sh → hook
• usr/<engineer>/agency/hookify/<name>.md → hookify
• usr/<engineer>/tools/<name>.* → tool
• usr/<engineer>/scripts/<name>.* → script

1. Check for existing symlink. If one exists, show target and ask to replace.

1. Create symlink based on type:

• command: ln -sf ../../usr/<engineer>/claude/commands/<name>.md .claude/commands/usr-<engineer>.<name>.md
• hookify: ln -sf ../usr/<engineer>/agency/hookify/<name>.md .claude/hookify.usr-<engineer>.<name>.local.md
• hook: create symlink + print the settings.local.json entry needed for manual wiring
• tool/script: print PATH instruction

1. Verify the symlink resolves.

1. Print confirmation.