PACTdocs / 0.1Back to PACT ↗

Documentation / agent hosts

Different providers. One coordination lifecycle.

Codex and Claude use thin launchers over the same host, bounded context compiler, MCP tools, observer, and provider-neutral driver.

Shared host responsibilities

  • Join with a complete objective and declared semantic surfaces
  • Renew presence independently of model turns
  • Synchronize project events after a durable cursor
  • Observe workspace changes and publish conservative overlays
  • Checkpoint evidence and leave with a final handoff

Codex launcher

pact-codex \
  --workspace ../project-codex \
  --objective "Implement the API producer" \
  --surface contract://SessionResponse \
  --sandbox workspace-write \
  -- "Implement, test, and report contract conflicts."

The Codex sandbox defaults to workspace-write; read-only is also supported.

Claude launcher

pact-claude \
  --workspace ../project-claude \
  --objective "Update the API consumer" \
  --surface contract://SessionResponse \
  --permission-mode acceptEdits \
  -- "Implement, test, and report contract conflicts."

Claude defaults to acceptEdits and also accepts default or plan.

Common controls

OptionPurpose
--cwdSelect the PACT project root
--workspaceAttribute edits to a Git worktree
--surfaceDeclare files, symbols, or contracts; repeatable
--endpointOverride the discovered local daemon
--modelForward an explicit provider model
--keep-sessionKeep the PACT session open after the provider exits
--no-observeDisable automatic workspace observation