Installing AIResearch in ChatGPT / Codex (Personal Marketplace)

July 16, 2026 · View on GitHub

The plugin ships a .codex-plugin/ manifest alongside the Claude Code manifest, so the same repository works in both ecosystems.

Personal (local) install

  1. Create the personal marketplace file ~/.agents/plugins/marketplace.json:
{
  "name": "wook-personal-plugins",
  "interface": { "displayName": "Wook Personal Plugins" },
  "plugins": [
    {
      "name": "airesearch",
      "source": { "source": "local", "path": "./airesearch" },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_USE"
      },
      "category": "Public Equity Investing"
    }
  ]
}
  1. Copy the plugin into the marketplace root (exclude repo internals):
mkdir -p ~/.agents/plugins/airesearch
rsync -a --delete \
  --include='.codex-plugin/***' --include='skills/***' \
  --include='assets/***' --include='README.md' --include='LICENSE*' \
  --exclude='*' \
  <repo>/ ~/.agents/plugins/airesearch/
  1. Restart the ChatGPT desktop app. The card appears under Plugins → Personal.

Data layer (optional)

Skills work without any key via web-search fallback. For the hosted MCP data layer, make AIRESEARCH_API_KEY available in the environment the desktop app inherits (see README for the variable format), then restart.

Submission assets

The packaged Codex manifest references:

  • assets/composer-icon.png
  • assets/logo-v2.png
  • assets/screenshot-snapshot.png
  • assets/screenshot-deep-dive.png
  • assets/screenshot-morning-brief.png

The screenshot source is kept at promo/codex-submission/screenshot-source.html. It is explicitly labeled as sample output so no generated image is mistaken for live market data.

Updating

After changing plugin files, re-run the rsync in step 2 and restart the app to pick up the new files.