GHE Background Agent Spawner

Spawn a Claude agent in a background Terminal window. The agent works autonomously while you continue chatting.

Task

Task: $ARGUMENTS.task Output: ${ARGUMENTS.output_file:-GHE_REPORTS/$(TZ='Australia/Brisbane' date +%Y%m%d%H%M%S%Z)task_result(Agent).md}

Instructions

Run the spawn script:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/spawn_background.py" \
  "Please complete this task and save the result to ${ARGUMENTS.output_file:-GHE_REPORTS/\$(TZ='Australia/Brisbane' date +%Y%m%d%H%M%S%Z)_task_result_(Agent).md}: $ARGUMENTS.task" \
  "$(pwd)"

Features

• Background execution: Terminal opens but returns focus to your current app
• Auto-approval: PreToolUse hook auto-approves safe operations (no --dangerously-skip-permissions needed)
• Security: Writes blocked outside project, dangerous commands denied
• macOS only: Uses Terminal.app and AppleScript

Security Model