aci-codex-connect
v0.1.0
Published
Installer for AI Context Intelligence Codex Connect.
Readme
ACI Connect CLI
Installer for AI Context Intelligence Codex Connect.
Target command after publishing:
npx aci-codex-connect setupLocal development command from this repository:
node tools/aci-connect/bin/aci-connect.js setup --app-url http://127.0.0.1:8765/appThe installer:
- creates a short-lived ACI setup session;
- opens ACI in the browser;
- waits for the signed-in user to approve pairing;
- receives a one-time tenant MCP token;
- stores the token outside
config.tomlusingACI_MCP_TOKEN; - writes the ACI MCP server block to
~/.codex/config.toml; - installs an ACI rule in
~/.codex/AGENTS.md; - installs an ACI skill in
~/.agents/skills/aci-connect/SKILL.md.
The CLI does not receive the user's web auth session. It only receives the tenant MCP token created for Codex.
On macOS, the default secure path stores the token in Keychain, sets ACI_MCP_TOKEN for future GUI apps through launchctl, and installs a shell loader for new Terminal sessions. Fully quit and reopen Codex or the IDE after setup so the MCP server can read ACI_MCP_TOKEN.
The generated Codex MCP config uses:
[mcp_servers.aci]
url = "https://your-aci-host.example/mcp"
bearer_token_env_var = "ACI_MCP_TOKEN"
enabled = true
default_tools_approval_mode = "prompt"It must not store the raw bearer token in ~/.codex/config.toml.
