Official

codex

Codex agent provider: runs the Codex CLI's app-server for each account.

The app opens the listing; nothing installs until an agent in your Plugins workspace has read the files and you enable the plugin. In a terminal: dvg install divergence/codex@0.2.5

Permissions in 0.2.5

  • Provide agents agents.provideMediumAdds agents to the app.Provide the Codex agent and pass its tool calls to plugin tools
  • Run named programs processMediumStarts the listed programs.Run the Codex CLI, and ask or tell the installer that owns it (npm or Homebrew) about a newer versionPrograms: codexnpmbrew
  • Environment variables envMediumReads the listed environment variables.Find each account's Codex home, and pass extra app-server arguments set in CODEX_ARGSVariables: HOMECODEX_HOMECODEX_ARGS
  • Read files fs.readMediumReads files in the listed places.Notice a conversation started in the Codex app or CLI, so it shows up at once, and read, once, the accounts the previous Codex provider keptPlaces: its own data folder~/.codex/sessions~/.codex/sessions/**~/.codex*/sessions~/.codex*/sessions/**

Files

plugin.json1.3 KB
{
  "id": "divergence/codex",
  "name": "codex",
  "version": "0.2.5",
  "description": "Codex agent provider: runs the Codex CLI's app-server for each account.",
  "pluginApi": ">=5 <6",
  "main": "main.ts",
  "listing": { "icon": "media/icon.svg" },
  "contributes": {
    "agents": [
      {
        "id": "codex",
        "name": "Codex",
        "icon": "icon.svg"
      }
    ]
  },
  "permissions": {
    "agents.provide": {
      "reason": "Provide the Codex agent and pass its tool calls to plugin tools"
    },
    "process": {
      "programs": [
        "codex",
        "npm",
        "brew"
      ],
      "reason": "Run the Codex CLI, and ask or tell the installer that owns it (npm or Homebrew) about a newer version"
    },
    "env": {
      "vars": [
        "HOME",
        "CODEX_HOME",
        "CODEX_ARGS"
      ],
      "reason": "Find each account's Codex home, and pass extra app-server arguments set in CODEX_ARGS"
    },
    "fs.read": {
      "scopes": [
        "data",
        "~/.codex/sessions",
        "~/.codex/sessions/**",
        "~/.codex*/sessions",
        "~/.codex*/sessions/**"
      ],
      "reason": "Notice a conversation started in the Codex app or CLI, so it shows up at once, and read, once, the accounts the previous Codex provider kept"
    }
  }
}

Versions

VersionPublishedPlugin APISizePermissionsStatus
0.2.5latestNov 21, 2026>=5 <6121.1 KB4 permissionsListed
0.2.4Nov 16, 2026>=5 <6120.2 KB4 permissionsListed
0.2.3Nov 11, 2026>=5 <695.2 KB4 permissionsListed
0.2.2Nov 9, 2026>=5 <688.9 KB4 permissionsListed
0.2.1Oct 27, 2026>=2 <484.1 KB4 permissionsListed

Reviews and comments

0 threads · 0 reviews

No comments yet.