council-execution

1# Council Query Execution
2 
3## Step 1: Run Query and Save to File
4 
5```bash
6bash ${CLAUDE_PLUGIN_ROOT}/scripts/run-council.sh --providers=gemini,openai -- "Your question"
7```
8 
9This outputs the path to the saved file (e.g., `.claude/council-cache/council-1734567890.md`).
10 
11**Flag syntax**: Use `=` with no spaces: `--providers=gemini,openai`
12 
13**Pass only the flags the user asked for.** Never add `--no-pane`, `--quiet`,
14`--no-cache` or `--no-auto-context` on your own judgment; they are the user's
15to choose, and the script already skips a pane that cannot open.
16 
17**CRITICAL**: Always place `--` before the prompt to prevent prompt text containing dashes from being parsed as flags.
18 
19**Run this Bash call with `timeout: 600000`** (ten minutes). The Bash tool's
20two-minute default is shorter than a slow council round, and inside tmux a
21provider failure makes the streaming pane offer the user a retry for
22`COUNCIL_RETRY_WAIT` seconds (default 45) and then runs another provider round
23if accepted. A call cut off mid-run loses the whole transcript, the answers
24that did arrive included.
25 
26## Step 2: Read and Display the Output VERBATIM
27 
28Use the **Read tool** to read the output file path returned by Step 1.
29 
30**If the file's first line is `<!-- council: round 1 was shown in the pane -->`**,
31the user already read every round-1 answer in the streaming pane. Do not
32reprint them. Instead, output one line per provider in round 1, taken from
33…