playbooks/roles/vhosts/acp_server_codex
2026-06-21 18:55:52 +08:00
..
defaults fix(macOS): use dynamic npm global bin path for codex adapter 2026-06-21 18:47:39 +08:00
handlers fix(macOS): correctly sequence launchctl unload and load by using listen rather than notify in handlers 2026-06-21 18:55:52 +08:00
tasks refactor(macOS): overhaul handlers to support dynamic OS routing via listen feature 2026-06-21 18:52:37 +08:00
templates fix(macOS): correct bridge adapter invocation syntax for acp endpoints 2026-06-21 18:27:22 +08:00
README.md fix: align xworkmate bridge ingress contract 2026-05-03 12:14:27 +08:00

acp_codex

Codex ACP deployment role for the internal runtime consumed by xworkmate-bridge.

Installs:

  • caddy
  • bubblewrap

Exposes:

  • raw Codex upstream: codex app-server --listen ws://127.0.0.1:9001
  • internal ACP listener: 127.0.0.1:9001

Notes:

  • xworkmate-app must not call a /codex public path.
  • Public app traffic goes through wss://xworkmate-bridge.svc.plus/acp or https://xworkmate-bridge.svc.plus/acp/rpc.
  • Provider selection is exposed through bridge acp.capabilities and xworkmate.routing.resolve, not provider-specific public URLs.
  • ACP_ALLOWED_ORIGINS defaults to https://xworkmate.svc.plus,http://localhost:*,http://127.0.0.1:*.