diff --git a/skills/kugetsu/scripts/kugetsu b/skills/kugetsu/scripts/kugetsu
index df16c43..c1e542c 100755
--- a/skills/kugetsu/scripts/kugetsu
+++ b/skills/kugetsu/scripts/kugetsu
@@ -1248,6 +1248,10 @@ cmd_init() {
 # Verbosity level for PM agent output (verbose, default, or quiet)
 # KUGETSU_VERBOSITY=default
 
+# Temporary directory for agent operations (default: ~/.local/share/opencode/tool-output)
+# Use this instead of /tmp which may be blocked by opencode in headless mode
+# KUGETSU_TEMP_DIR="$HOME/.local/share/opencode/tool-output"
+
 # Git server configurations
 # Format: GIT_SERVERS["hostname"]="https://hostname"
 # Add servers with: kugetsu server add <name> <url>