fix: add KUGETSU_TEMP_DIR to config template

Add KUGETSU_TEMP_DIR config option to cmd_init template with default
value of ~/.local/share/opencode/tool-output (opencode-allowed directory).

This allows users to configure a temp directory that opencode can access
instead of /tmp which may be blocked in headless mode.

Fixes #73

docs/SUBAGENT_WORKFLOW.md

@@ -8,7 +8,8 @@ Subagents work autonomously on issues. They research, build, and post progress/f
 
 ### Research Task (e.g., Issue #1)
 1. Subagent explores repo, runs opencode research
-2. Subagent writes findings to `/tmp/findings-{issue}.md`
+2. Subagent writes findings to `${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/findings-{issue}.md`
+   - Note: Use KUGETSU_TEMP_DIR instead of /tmp since opencode blocks /tmp access in headless mode
 3. Subagent posts findings as issue comment via curl
 4. User replies with feedback/questions on Gitea
 5. Subagent (or Hermes) reads reply, continues research
@@ -65,7 +66,7 @@ curl -X POST "https://git.example.com/api/v1/repos/{owner}/{repo}/pulls" \
 
 ```json
 {
-  "goal": "Work on Issue #{N}: {title}\n\nSteps:\n1. Explore ~/repositories/kugetsu\n2. Run opencode research on {specific question}\n3. Write findings to /tmp/findings-{N}.md\n4. cat /tmp/findings-{N}.md to display\n5. Post as issue comment via:\n   curl -X POST 'https://git.example.com/api/v1/repos/shoko/kugetsu/issues/{N}/comments' \\\n     -H 'Authorization: token ${GITEA_TOKEN}' \\\n     -H 'Content-Type: application/json' \\\n     -d @/tmp/findings-{N}.md\n6. Ask 2-3 clarifying questions at end for user\n\nToken: abcdefg012345\nRepo: ~/repositories/kugetsu",
+  "goal": "Work on Issue #{N}: {title}\n\nSteps:\n1. Explore ~/repositories/kugetsu\n2. Run opencode research on {specific question}\n3. Write findings to ${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/findings-{N}.md\n4. cat the findings file to display\n5. Post as issue comment via:\n   curl -X POST 'https://git.example.com/api/v1/repos/shoko/kugetsu/issues/{N}/comments' \\\n     -H 'Authorization: token ${GITEA_TOKEN}' \\\n     -H 'Content-Type: application/json' \\\n     -d @${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/findings-{N}.md\n6. Ask 2-3 clarifying questions at end for user\n\nToken: abcdefg012345\nRepo: ~/repositories/kugetsu\n\nNote: Use KUGETSU_TEMP_DIR instead of /tmp since opencode blocks /tmp access in headless mode",
   "context": "{additional context}",
   "toolsets": ["terminal"]
 }

docs/hermes-communication-patterns.md

@@ -150,8 +150,8 @@ result = delegate_task(
 Steps:
 1. Read existing docs in ~/repositories/kugetsu/docs/
 2. Identify message passing mechanisms used
-3. Write findings to /tmp/findings-4.md
-4. cat /tmp/findings-4.md
+3. Write findings to ${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/findings-4.md
+4. cat findings file
 5. Post findings as Gitea issue comment
 
 Gitea: git.example.com
@@ -178,8 +178,8 @@ terminal(
 ### 4.3 Posting Findings to Gitea (from subagent)
 
 ```bash
-# Write findings to temp file first
-cat > /tmp/findings-4.md << 'EOF'
+# Write findings to temp file first (use KUGETSU_TEMP_DIR instead of /tmp)
+cat > ${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/findings-4.md << 'EOF'
 # Research Findings for Issue #4
 
 ## Message Passing Mechanisms Identified
@@ -194,10 +194,10 @@ EOF
 
 # Post as issue comment
 curl -X POST "git.example.com/api/v1/repos/shoko/kugetsu/issues/4/comments" \
-  -H "Authorization: token &lt;YOUR_GITEA_TOKEN&gt;" \
+  -H "Authorization: token <YOUR_GITEA_TOKEN>" \
   -H "Content-Type: application/json" \
   -H "User-Agent: Kugetsu-Subagent/1.0" \
-  -d @/tmp/findings-4.md \
+  -d @${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/findings-4.md \
   --max-time 30 \
   --retry 3 \
   --retry-delay 5

docs/hermes-setup.md

@@ -180,7 +180,8 @@ For Kugetsu's parallel workflow, prefer `terminal(opencode run ...)` for coding
 
 ```bash
 # One-shot task (blocks until complete)
-terminal(command="opencode run 'Fix issue #1: add retry logic'", workdir="/tmp/issue-1")
+# Note: Use KUGETSU_TEMP_DIR instead of /tmp for opencode workdir
+terminal(command="opencode run 'Fix issue #1: add retry logic'", workdir="${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/issue-1")
 
 # Background TUI (interactive, returns session_id)
 terminal(command="opencode", workdir="~/project", background=true, pty=true)
@@ -319,7 +320,7 @@ git push --force-with-lease origin my-branch
    opencode run "Research/fix issue #{N}"
 
 4. Agent Posts to Gitea
-   curl -X POST .../issues/{N}/comments -d @/tmp/findings-{N}.md
+   curl -X POST .../issues/{N}/comments -d @${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/findings-{N}.md
 
 5. User Reviews on Gitea
    Comments on issues/PRs

docs/kugetsu-setup.md

@@ -261,7 +261,7 @@ For long-running tasks, SSH and spawn:
 
 ```bash
 ssh -p 2222 <username>@<host-ip> \
-  "kugetsu start github.com/shoko/kugetsu#11 'Implement feature' && echo 'Task done' | tee /tmp/task.log"
+  "kugetsu start github.com/shoko/kugetsu#11 'Implement feature' && echo 'Task done' | tee \${KUGETSU_TEMP_DIR:-${HOME}/.local/share/opencode/tool-output}/task.log"
 ```
 
 ### Port Forwarding for Web UI

docs/opencode-usage.md

@@ -97,9 +97,9 @@ cd $REVIEW && opencode run 'Review this PR vs main...'
 
 ```python
 delegate_task(tasks=[
-  {"goal": "Fix issue #1", "context": "...", "workdir": "/tmp/issue-1"},
-  {"goal": "Fix issue #2", "context": "...", "workdir": "/tmp/issue-2"},
-  {"goal": "Fix issue #3", "context": "...", "workdir": "/tmp/issue-3"},
+  {"goal": "Fix issue #1", "context": "...", "workdir": "${KUGETSU_TEMP_DIR}/issue-1"},
+  {"goal": "Fix issue #2", "context": "...", "workdir": "${KUGETSU_TEMP_DIR}/issue-2"},
+  {"goal": "Fix issue #3", "context": "...", "workdir": "${KUGETSU_TEMP_DIR}/issue-3"},
 ], max_iterations=50)
 ```
 
@@ -107,14 +107,15 @@ delegate_task(tasks=[
 - Cannot use: `delegate_task`, `clarify`, `memory`, `send_message` within subagents
 - Tasks must be fully self-contained
 - Exit with Ctrl+C or `process(action="kill")`, NOT `/exit`
+- Note: Use KUGETSU_TEMP_DIR instead of /tmp since opencode blocks /tmp in headless mode
 
 ### Terminal Parallel Calls
 
 No hard cap. Fire multiple `opencode run` in parallel:
 ```bash
-opencode run 'Fix issue #1' --workdir /tmp/issue-1 &
-opencode run 'Fix issue #2' --workdir /tmp/issue-2 &
-opencode run 'Fix issue #3' --workdir /tmp/issue-3 &
+opencode run 'Fix issue #1' --workdir ${KUGETSU_TEMP_DIR}/issue-1 &
+opencode run 'Fix issue #2' --workdir ${KUGETSU_TEMP_DIR}/issue-2 &
+opencode run 'Fix issue #3' --workdir ${KUGETSU_TEMP_DIR}/issue-3 &
 ```
 
 ### Schema Constraint

skills/kugetsu/pm/SKILL.md

@@ -84,7 +84,7 @@ When a request comes in:
 **You:** `kugetsu start <domain>/<user>/<repo>#126 Update README with installation instructions`
 
 **User:** "Create a file at /tmp/test.txt"
-**You:** `kugetsu start <domain>/<user>/<repo>#127 Create a file at /tmp/test.txt`
+**You:** `kugetsu start <domain>/<user>/<repo>#127 Create a file at ${KUGETSU_TEMP_DIR:-~/.local/share/opencode/tool-output}/test.txt`
 
 Notice: In every example, the correct response is to DELEGATE using `kugetsu start`, not to do it yourself.
 

skills/kugetsu/scripts/kugetsu

@@ -641,6 +641,99 @@ EOF
     fi
 }
 
+parse_issue_ref_from_message() {
+    local message="$1"
+    
+    local gitserver=""
+    local owner=""
+    local repo=""
+    local issue_number=""
+    
+    if echo "$message" | grep -qE '[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+/(issues|pull)/[0-9]+'; then
+        gitserver=$(echo "$message" | grep -oE '[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+' | head -1 | sed 's/\/[^/]*\/[^/]*$//')
+        local full_path=$(echo "$message" | grep -oE '[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+/(issues|pull)/[0-9]+' | head -1)
+        owner=$(echo "$full_path" | cut -d'/' -f2)
+        repo=$(echo "$full_path" | cut -d'/' -f3)
+        issue_number=$(echo "$full_path" | grep -oE '[0-9]+$' | head -1)
+    elif echo "$message" | grep -qE '[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+#([0-9]+)'; then
+        owner=$(echo "$message" | grep -oE '[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+#' | sed 's/#$//' | cut -d'/' -f1)
+        repo=$(echo "$message" | grep -oE '[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+#' | sed 's/#$//' | cut -d'/' -f2)
+        issue_number=$(echo "$message" | grep -oE '#[0-9]+' | grep -oE '[0-9]+' | head -1)
+    fi
+    
+    echo "${gitserver}|${owner}|${repo}|${issue_number}"
+}
+
+get_missing_info() {
+    local parsed="$1"
+    local gitserver=$(echo "$parsed" | cut -d'|' -f1)
+    local owner=$(echo "$parsed" | cut -d'|' -f2)
+    local repo=$(echo "$parsed" | cut -d'|' -f3)
+    local issue_number=$(echo "$parsed" | cut -d'|' -f4)
+    
+    local missing=""
+    [ -z "$gitserver" ] && missing="${missing}git server, "
+    [ -z "$owner" ] && missing="${missing}owner, "
+    [ -z "$repo" ] && missing="${missing}repository, "
+    [ -z "$issue_number" ] && missing="${missing}issue number, "
+    
+    echo "$missing" | sed 's/, $//'
+}
+
+build_missing_info_context() {
+    local missing="$1"
+    if [ -n "$missing" ]; then
+        echo ""
+        echo "NOTE: This task delegation has no information about: ${missing}."
+        echo "We need them if user wants to work on a specific issue. Otherwise we don't need it."
+    fi
+}
+
+find_worktrees_by_issue_number() {
+    local issue_number="$1"
+    local results=""
+    
+    if [ ! -d "$WORKTREES_DIR/.kugetsu-worktrees" ]; then
+        echo ""
+        return
+    fi
+    
+    for wt in "$WORKTREES_DIR/.kugetsu-worktrees"/*; do
+        if [ -d "$wt" ]; then
+            local wt_issue_number=$(echo "$wt" | grep -oE '#?[0-9]+$' | grep -oE '[0-9]+' | head -1)
+            if [ "$wt_issue_number" = "$issue_number" ]; then
+                results="${results}${wt}:worktree
+"
+            fi
+        fi
+    done
+    
+    echo "$results"
+}
+
+find_sessions_by_issue_number() {
+    local issue_number="$1"
+    local results=""
+    
+    if [ ! -d "$SESSIONS_DIR" ]; then
+        echo ""
+        return
+    fi
+    
+    for session_file in "$SESSIONS_DIR"/*.json; do
+        if [ -f "$session_file" ]; then
+            local session_issue_ref=$(basename "$session_file" .json | sed 's/_/\//g')
+            local session_issue_number=$(echo "$session_issue_ref" | grep -oE '#?[0-9]+$' | grep -oE '[0-9]+' | head -1)
+            if [ "$session_issue_number" = "$issue_number" ]; then
+                results="${results}${session_file}:session
+"
+            fi
+        fi
+    done
+    
+    echo "$results"
+}
+
 cmd_delegate() {
     local message="${1:-}"
     local verbosity="${KUGETSU_VERBOSITY:-default}"
@@ -660,6 +753,70 @@ cmd_delegate() {
     mkdir -p "$LOGS_DIR"
     local log_file="$LOGS_DIR/delegate-$(date +%s).log"
     
+    local parsed=$(parse_issue_ref_from_message "$message")
+    local gitserver=$(echo "$parsed" | cut -d'|' -f1)
+    local owner=$(echo "$parsed" | cut -d'|' -f2)
+    local repo=$(echo "$parsed" | cut -d'|' -f3)
+    local issue_number=$(echo "$parsed" | cut -d'|' -f4)
+    
+    local missing_info=$(get_missing_info "$parsed")
+    local context_injection=""
+    if [ -n "$missing_info" ]; then
+        context_injection=$(build_missing_info_context "$missing_info")
+        echo "NOTE: Delegation missing information: ${missing_info}"
+    fi
+    
+    local candidates=""
+    local candidate_count=0
+    
+    if [ -n "$issue_number" ]; then
+        local worktrees=$(find_worktrees_by_issue_number "$issue_number")
+        local sessions=$(find_sessions_by_issue_number "$issue_number")
+        
+        while IFS=: read -r path type; do
+            if [ -n "$path" ]; then
+                candidate_count=$((candidate_count + 1))
+                candidates="${candidates}${candidate_count}) ${path} (${type})
+"
+            fi
+        done <<< "$worktrees"
+        
+        while IFS=: read -r path type; do
+            if [ -n "$path" ]; then
+                candidate_count=$((candidate_count + 1))
+                candidates="${candidates}${candidate_count}) ${path} (${type})
+"
+            fi
+        done <<< "$sessions"
+    fi
+    
+    local use_worktree=""
+    if [ $candidate_count -gt 0 ]; then
+        echo "Found $candidate_count existing worktree(s)/session(s) for issue #${issue_number}:"
+        echo "$candidates"
+        echo "r) Delegate anyway (without routing)"
+        echo "Which one to use? [1-${candidate_count}/r]: "
+        read -r choice
+        
+        if [ "$choice" = "r" ] || [ -z "$choice" ]; then
+            use_worktree=""
+        elif [ "$choice" -ge 1 ] && [ "$choice" -le "$candidate_count" ]; then
+            local selected=$(echo "$candidates" | sed -n "${choice}p")
+            use_worktree=$(echo "$selected" | sed 's/) .*//')
+        fi
+    fi
+    
+    local final_message="${message}${context_injection}"
+    
+    if [ -n "$use_worktree" ]; then
+        if [ -d "$use_worktree" ]; then
+            echo "Using worktree: $use_worktree"
+            final_message="${final_message}
+
+NOTE: Worktree selected: ${use_worktree}"
+        fi
+    fi
+    
     local temp_dir="${KUGETSU_TEMP_DIR:-$HOME/.local/share/opencode/tool-output}"
     
     mkdir -p "$ENV_DIR"
@@ -671,7 +828,7 @@ cmd_delegate() {
     fi
     env_sh="${env_sh}set +a; "
     
-    nohup sh -c "${env_sh}opencode run '$message' --continue --session '$pm_session' >> '$log_file' 2>&1" > /dev/null 2>&1 &
+    nohup sh -c "${env_sh}opencode run '${final_message}' --continue --session '$pm_session' >> '$log_file' 2>&1" > /dev/null 2>&1 &
     disown
     echo "Delegated to PM agent (logged to $(basename "$log_file"))"
     echo "Verbosity: $verbosity"
@@ -1091,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>
@@ -1439,12 +1600,13 @@ cmd_continue() {
 
     echo "Continuing session for '$session_name'..."
     # Note: --continue always allowed (existing sessions don't count toward limit)
+    # Wrap in subshell with cd to ensure worktree directory is set correctly in session DB
     if [ -n "$worktree_path" ] && [ -d "$worktree_path" ]; then
         echo "Using worktree: $worktree_path"
         if [ "$DEBUG_MODE" = true ]; then
-            opencode run "$message" --continue --session "$opencode_session_id" --dir "$worktree_path" 2>&1 | tee "$session_path.debug.log" &
+            (cd "$worktree_path" && opencode run "$message" --continue --session "$opencode_session_id" --dir "$worktree_path" 2>&1) | tee "$session_path.debug.log" &
         else
-            opencode run "$message" --continue --session "$opencode_session_id" --dir "$worktree_path" 2>&1 &
+            (cd "$worktree_path" && opencode run "$message" --continue --session "$opencode_session_id" --dir "$worktree_path" 2>&1) &
         fi
     else
         if [ "$DEBUG_MODE" = true ]; then
@@ -1602,19 +1764,21 @@ cmd_destroy() {
     if [ "$target" = "base" ]; then
         if [ "$force" = true ]; then
             local base_session_id=$(get_base_session_id)
+            local pm_agent_session_id=$(get_pm_agent_session_id)
             rm -f "$SESSIONS_DIR/base.json"
-            local pm_agent=$(get_pm_agent_session_id)
-            if [ -n "$pm_agent" ] && [ "$pm_agent" != "null" ]; then
-                rm -f "$SESSIONS_DIR/pm-agent.json"
-                echo '{"base": null, "pm_agent": null, "issues": {}}' > "$INDEX_FILE"
-            else
-                echo '{"base": null, "pm_agent": null, "issues": {}}' > "$INDEX_FILE"
-            fi
+            rm -f "$SESSIONS_DIR/pm-agent.json"
+            rm -f "$SESSIONS_DIR/issue-"*.json 2>/dev/null || true
+            echo '{"base": null, "pm_agent": null, "issues": {}}' > "$INDEX_FILE"
+            
             if [ -n "$base_session_id" ] && [ "$base_session_id" != "null" ]; then
-                echo "Deleting opencode session: $base_session_id"
-                opencode session delete "$base_session_id" 2>/dev/null || echo "Warning: Could not delete session from opencode (may already be deleted)"
+                echo "Deleting base session: $base_session_id"
+                opencode session delete "$base_session_id" 2>/dev/null || echo "Warning: Could not delete base session"
             fi
-            echo "Base session destroyed"
+            if [ -n "$pm_agent_session_id" ] && [ "$pm_agent_session_id" != "null" ]; then
+                echo "Deleting PM agent session: $pm_agent_session_id"
+                opencode session delete "$pm_agent_session_id" 2>/dev/null || echo "Warning: Could not delete PM agent session"
+            fi
+            echo "Base and PM agent sessions destroyed"
         else
             echo "Error: destroying base session requires --base -y" >&2
             exit 1
@@ -1712,6 +1876,9 @@ main() {
         env)
             cmd_env "$@"
             ;;
+        post-comment)
+            cmd_post_comment "$@"
+            ;;
         doctor)
             cmd_doctor "$@"
             ;;