Synaptic.Tools.CodexExec (synaptic v0.3.0-alpha.8)

View Source

Adapter that delegates a Synaptic chat request to local Codex non-interactive mode.

This adapter runs codex exec as a local subprocess and returns the final Codex response. It is useful when a workflow wants to delegate a bounded coding or repository-reasoning task to Codex without changing Synaptic's adapter facade.

The adapter does not implement Synaptic's OpenAI-style tool-call loop. Codex can still use tools configured in Codex itself, but tools: and mcp: entries passed through Synaptic.Tools.chat/2 are rejected because there is no stable mapping from Codex exec output back to OpenAI tool-call messages.

Configuration

config :synaptic, Synaptic.Tools.CodexExec,
  codex_bin: "/Applications/Codex.app/Contents/Resources/codex",
  model: "gpt-5.5",
  model_reasoning_effort: "low",
  sandbox: :read_only,
  approval_policy: :never,
  ephemeral: true,
  timeout_ms: 300_000

Per-call options override application config.