@goplausible/ac2-plugin-codex

AC2 plugin for Codex. It pairs Codex with an AC2 wallet such as Regent so you can chat with your agent from your phone, approve what it does, sign with your own keys, and pay for x402 resources — while the wallet keeps custody of every key.

What is AC2?

AC2 (Agent-Controller Communication) is GoPlausible's open protocol connecting AI agents to user-controlled wallets over an end-to-end encrypted, peer-to-peer link (Liquid Auth / FIDO2 pairing + WebRTC DataChannels). The agent never sees a private key: every signature and payment is approved by the user in their wallet with a passkey or biometric. The same protocol powers the AC2 plugins for Claude Code and OpenClaw — this package brings it to Codex.

Features

• Two-way chat with your agent from Regent — send messages, images, and files from your phone; get replies, live activity status, and token usage.
• Remote approvals — when Codex wants to run a command or change files, the approval prompt arrives in your wallet chat; reply yes/no from the phone.
• Cryptographic signing with ac2_sign — messages, typed data, and transactions across Algorand, EVM, and Solana; verified locally with the ac2_verify_* tools.
• Capability discovery with ac2_capabilities — identities, accounts, and what the connected wallet can sign.
• x402 paid HTTP resources — discover payment requirements, browse the Bazaar directory, and pay per-request from your wallet with make_http_request_with_x402_ac2.
• Slash commands everywhere — the same /ac2 … command set as the Claude and OpenClaw plugins, plus /skill search over all installed Codex skills (with autocomplete in Regent) and direct /<skill-name> invocation.

Requirements

• Node 20+ and the Codex CLI (or desktop app) with plugin support.
• An AC2 wallet such as Regent on your phone.

Install

From the GoPlausible plugin marketplace:

codex plugin marketplace add https://github.com/GoPlausible/codex-plugins.git
codex plugin add ac2@goplausible

Codex adds the plugin enable block during install. To let the AC2 MCP server run without asking for approval on every AC2 tool call, add only this block to ~/.codex/config.toml:

[plugins."ac2@goplausible".mcp_servers."ac2-channel"]
enabled = true
default_tools_approval_mode = "approve"

Wallet signatures, x402 payments, and passkey approvals still require explicit approval in Regent.

Then start a new Codex thread and pair your wallet:

Pair my AC2 wallet.

Codex shows a QR code and deep link — scan it with Regent (or open the link on your phone) and approve with your passkey. Pairing persists; future sessions reconnect automatically with no QR.

Update

codex plugin marketplace upgrade goplausible
codex plugin add ac2@goplausible

Start a new thread after updating so Codex picks up the new version.

Use

From the terminal side, just ask Codex naturally:

• "What's my wallet status?" / "Show my wallet capabilities."
• "Sign this message with my wallet." — Regent shows the approval modal.
• "Fetch this x402 resource and pay for it." — payment is approved in-wallet.

From Regent, chat with your Codex agent directly. Available commands (type / for autocomplete):

• /ac2 — list AC2 commands (status, capabilities, version, forget)
• /skill <name> [args] — search and run any installed Codex skill
• /<skill-name> [args] — run a skill directly, same as Codex's $ style
• /clear — start a fresh conversation

Signing, x402 payments, approvals, images, and file attachments all work from the wallet chat as well.

Environment

| Variable | Purpose | |---|---| | AC2_LIQUID_AUTH_SERVER | Override the Liquid Auth relay (default: GoPlausible's) | | AC2_STATE_DIR | Override the state directory (default ~/.codex/ac2/) | | AC2_AGENT_DID | Override the agent's DID | | AC2_RTC_CONFIG | Custom WebRTC configuration (JSON) |

Links

• AC2 SDK & protocol: https://github.com/GoPlausible/ac2-sdk
• Regent wallet: https://liquidauth.goplausible.xyz/download/regent.apk
• GoPlausible: https://goplausible.com

Apache-2.0 © GoPlausible