spar-cli 0.4.0

Two AI coding agents alternate implementing and reviewing GitHub issues until a PR converges.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# OpenAI Codex. Ships inside the ChatGPT desktop app on macOS, or standalone.
#
# Note: `codex exec review` is deliberately not used. It refuses a custom prompt
# alongside --base and returns prose regardless of --output-schema, so it cannot
# produce a machine-checkable verdict.
command = [
  "codex", "exec", "--json", "--skip-git-repo-check",
  ["-s", "workspace-write"],
  ["-m", "{model}"],
  ["-c", "model_reasoning_effort={effort}"],
  ["-C", "{cwd}"],
  ["--output-schema", "{schema_file}"],
  "--", "{prompt}",
]
output = "jsonl"
message_path = "item.text"
search_paths = [
  "/Applications/ChatGPT.app/Contents/Resources",
  "~/.codex/bin",
  "/opt/homebrew/bin",
  "/usr/local/bin",
  "~/.local/bin",
]

# Hints for `spar init`. Never validated against, only written as comments.
#
# Codex enumerates neither set in its help. The effort list is its own enum, in
# its own order, read out of the binary. The models were read out of the binary
# too, and that is what made this list incomplete: gpt-5.3-codex-spark is not a
# string in the binary at all. It arrives in the model list the server hands the
# CLI, cached at ~/.codex/models_cache.json, which is the better place to look.
# Which models an account may actually call is a separate question again from
# which ones exist, so treat the list as a starting point rather than a promise.
#
# Spark is last because it is not a peer of the rest. It is a generation older,
# ultra-fast, 128k of context against 272k, text only, and no priority tier. It
# is here because it bills against its own quota allowance rather than the
# general one, which makes it the one entry on this list worth naming under
# [agents.codex.fallback]: a stand in for a weekly limit has to draw on a
# different pool than the model that just hit it.
models = ["gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.6-pro", "gpt-5.5", "gpt-5.3-codex-spark"]
efforts = ["ultra", "max", "xhigh", "high", "medium", "low", "minimal", "none"]
options_note = "Codex lists neither set in its help. ~/.codex/models_cache.json is what your account is currently offered, and effort is passed through as -c model_reasoning_effort=..."

[message_match]
type = "item.completed"
"item.type" = "agent_message"