Problem
sessions wake --model=value ... works, but the documented/help shape with a space-separated flag value fails:
sessions wake --headless --model openai-codex/gpt-5.5 --message "Reply ok" <session>
Observed error:
[wake] ERROR unexpected word: openai-codex/gpt-5.5
Equals form works:
sessions wake --headless --model=openai-codex/gpt-5.5 --message "Reply ok" <session>
and launches pi with:
Model: openai-codex/gpt-5.5
Why it matters
The help text advertises:
which implies both common CLI forms should work. The space-separated form is also what agents naturally write after reading --help, and what existing examples tend to show for flags with values.
This came up while trying to run a local sessions wake peer-review with OpenAI (openai-codex/gpt-5.5) because Claude usage was exhausted.
Reproduction sketch
SMOKE_DIR=$(mktemp -d)
SESSION="model-smoke-$(date +%s)"
sessions new "$SESSION" --cwd "$SMOKE_DIR"
# Fails with unexpected word
sessions wake --headless --model openai-codex/gpt-5.5 --message "Reply ok" "$SESSION"
# Works
sessions wake --headless --model=openai-codex/gpt-5.5 --message "Reply ok" "$SESSION"
Acceptance criteria
sessions wake --model foo <session> parses the same as --model=foo.
- Add a BATS regression test for the space-separated form.
- If the root cause is a
usage parser limitation rather than sessions-specific code, document the limitation and update examples/help accordingly.
Problem
sessions wake --model=value ...works, but the documented/help shape with a space-separated flag value fails:Observed error:
Equals form works:
and launches pi with:
Why it matters
The help text advertises:
which implies both common CLI forms should work. The space-separated form is also what agents naturally write after reading
--help, and what existing examples tend to show for flags with values.This came up while trying to run a local
sessions wakepeer-review with OpenAI (openai-codex/gpt-5.5) because Claude usage was exhausted.Reproduction sketch
Acceptance criteria
sessions wake --model foo <session>parses the same as--model=foo.usageparser limitation rather than sessions-specific code, document the limitation and update examples/help accordingly.