Webfetch Patterns

Gemini CLI Web Bridge

Execution Model

Run as subagent to isolate tmux noise from main session.

Output contract: Return ONLY raw content wrapped in <data_transfer> tags, then terminate immediately. No logs, no status updates, no commentary.

Protocol

1. Init Session

S="fetch_$(date +%s)"
tmux new-session -d -s "$S" -x 200 -y 50
tmux send-keys -t "$S" 'gemini' Enter
sleep 2

2. Send Request

tmux send-keys -t "$S" "Fetch and return full text from: [URL]. No summaries." Enter

3. Poll Until Complete

Loop until READY or FAILURE. Wait 3s between polls, max 15 attempts.

tmux capture-pane -t "$S" -p | awk '
  /Type your message/ {print "READY"; exit}
  /[Rr]ate.[Ll]imit|[Qq]uota/ {print "FAILURE:THROTTLED"; exit}
  /[Ss]ign.[Ii]n|[Ll]ogin/ {print "FAILURE:AUTH"; exit}
  /Internal error|unexpected/ {print "FAILURE:ERROR"; exit}
  END {print "PENDING"}
'

Stuck in PENDING? Visual State Check

Capture pane and inspect where YOUR QUERY appears relative to the input box:

Enter NOT sent — query is INSIDE the bordered box:

╭─────────────────────────────────────╮
│ > Your query text here              │
╰─────────────────────────────────────╯

→ Fix: tmux send-keys -t "$S" Enter

Enter WAS sent — query is OUTSIDE box, activity below:

> Your query text here
⠋ Working...
╭─────────────────────────────────────╮
│ > Type your message                 │
╰─────────────────────────────────────╯

→ Keep polling. For complex queries, extend max attempts to 30.

4. Extract & Return

tmux capture-pane -t "$S" -p -S -1500 > /tmp/"$S".txt
cat /tmp/"$S".txt
tmux kill-session -t "$S"
rm /tmp/"$S".txt

Parse the Gemini response from captured output. Strip tmux UI artifacts (boxes, prompts, spinners). Return only the substantive content:

<data_transfer>
[extracted content only]
</data_transfer>

Failure Handling

On any FAILURE:* status or max poll timeout:

<data_transfer>
ERROR: [reason] - Unable to fetch [URL]
</data_transfer>

Converted and distributed by TomeVault — claim your Tome and manage your conversions.