plugin.json

{
  "id": "codex_cli",
  "label": "Codex CLI",
  "description": "Install, configure, and launch Codex CLI instances served by the local EmuLLM relay (router/gpt-5.6-sol), each in its own CODEX_HOME and workspace.",
  "summary": "Manage multiple Codex instances (via EmuLLM router/gpt-5.6-sol) with a directory of isolated homes.",
  "version": "2.0.0",
  "entrypoint": "plugin.py",
  "scan": "startup",
  "routePrefix": "/codex_cli",
  "adminPage": "/codex_cli/admin",
  "docs": "ADMIN.md",
  "kind": "custom",
  "instances": {
    "default": {
      "model": "router/gpt-5.6-sol",
      "providerId": "emullm",
      "providerLabel": "EmuLLM Router",
      "baseUrl": "http://127.0.0.1:8801/v1",
      "wireApi": "responses",
      "envKey": "EMULLM_API_KEY",
      "workspaceDir": "C:\\snet\\PeTTa\\repos\\symbolic_learner_workbench"
    }
  },
  "activeInstance": "default",
  "newInstanceName": "",
  "plugin-init": [],
  "plugin-lifecycle": {
    "standalone": false,
    "hooks": {
      "install": null,
      "installAfter": null,
      "uninstall": null,
      "uninstallAfter": null,
      "workbenchStartup": "initialize",
      "workbenchStartupAfter": null,
      "workbenchShutdown": null,
      "workbenchShutdownAfter": null,
      "workspaceStartup": null,
      "workspaceStartupAfter": null,
      "workspaceShutdown": null,
      "workspaceShutdownAfter": null
    },
    "note": "Embedded plugin: adds a configure router plus a REST API and a dedicated manager page to the workbench API process; no standalone server. Codex is a CLI invoked on demand, so only workbenchStartup (initialize) is used, to seed the instance registry and probe the local install."
  },
  "plugin-install": {
    "requires": [],
    "install": "npm install --no-audit --no-fund",
    "files": [
      {
        "path": "plugin.json",
        "description": "Manifest holding the Codex instance registry and configure page."
      },
      {
        "path": "package.json",
        "description": "Declares the @openai/codex dependency installed by npm install."
      }
    ],
    "steps": [
      "Ensure Node.js 22+ is on PATH.",
      "Run 'npm install' in this plugin's directory to download @openai/codex into node_modules.",
      "Open the Codex Instances page (or the configure page) to create, configure, and launch instances."
    ]
  },
  "plugin-uninstall": {
    "uninstall": "npm uninstall @openai/codex",
    "steps": [
      "Delete node_modules and package-lock.json in this plugin directory.",
      "Remove homes/ if you no longer need the generated Codex instance homes.",
      "Set scan: 'disabled' or delete the codex_cli directory to unload the plugin."
    ]
  },
  "ui": {
    "pages": [
      {
        "id": "configure",
        "label": "Codex CLI",
        "kind": "configure",
        "descriptor": "/codex_cli/admin",
        "glyph": "\u2699",
        "group": "PLUGINS"
      },
      {
        "id": "manage",
        "label": "Codex Instances",
        "kind": "user",
        "descriptor": "/codex_cli/manage",
        "external": true,
        "glyph": "\u25a6",
        "group": "PLUGINS"
      }
    ]
  }
}