codex-api-plugins is a public plugin collection for Codex API mode.

The repository now keeps only two plugins that are practical in a local, Windows-first workflow:

Codex plugin examples often assume bundled connectors or ChatGPT app login.

This repository is built for a different path:

• Codex API mode first
• local plugin installation
• explicit marketplace registration
• reproducible setup from a normal git clone
• no machine-local absolute paths or committed secrets in plugin runtime config

1. Clone this repository to a stable local path.

2. Run:

   powershell -ExecutionPolicy Bypass -File .\scripts\install-home-local.ps1

3. Restart Codex Desktop.

4. Set the environment variables for the plugin(s) you plan to use.

5. In the plugin picker, verify that GitLab MCP and KM Confluence + Draw.io are visible.

Detailed setup is in docs/install.md.

Use the plugins with plugin mentions:

[@gitlab-mcp](plugin://gitlab-mcp@codex-api-plugins)
[@km-confluence-drawio](plugin://km-confluence-drawio@codex-api-plugins)

Example prompts:

• [@gitlab-mcp](plugin://gitlab-mcp@codex-api-plugins) inspect this merge request URL and tell me the top risks
• [@gitlab-mcp](plugin://gitlab-mcp@codex-api-plugins) inspect the latest failed pipeline on this MR and explain the most likely root cause
• [@km-confluence-drawio](plugin://km-confluence-drawio@codex-api-plugins) search Lenovo KM for this topic and summarize the most relevant pages
• [@km-confluence-drawio](plugin://km-confluence-drawio@codex-api-plugins) inspect this KM page, then turn the main flow into a draw.io architecture diagram

Detailed usage is in docs/usage/gitlab-mcp.md and docs/usage/km-confluence-drawio.md.

.
├── .agents/plugins/marketplace.json
├── docs/
├── plugins/
│   ├── gitlab-mcp/
│   └── km-confluence-drawio/
└── scripts/

• plugins/<plugin-name>/ contains each plugin bundle
• .agents/plugins/marketplace.json exposes the marketplace entries
• docs/ contains install, usage, troubleshooting, and development notes
• scripts/ contains local install and validation helpers

gitlab-mcp depends on a valid GitLab PAT and a correct GITLAB_API_URL ending in /api/v4.

km-confluence-drawio currently exposes a read-first KM MCP server for page search and inspection:

• confluence_search
• confluence_get_page
• confluence_get_page_children
• confluence_get_comments
• confluence_get_labels

For larger Confluence upload or conversion flows, use the bundled helper scripts inside plugins/km-confluence-drawio/skills/confluence/scripts/.

Important limitation:

• the km-mcp server is aligned to CONFLUENCE_PERSONAL_TOKEN
• several older helper scripts under plugins/km-confluence-drawio/skills/confluence/scripts/ still follow a legacy CONFLUENCE_USERNAME + CONFLUENCE_API_TOKEN / password model
• those script-backed write flows are included as reference utilities, but they are not yet normalized to the same KM personal-token path as km-mcp

Troubleshooting guidance lives in docs/troubleshooting.md.

If you add or replace plugins in this repository, update the marketplace, install docs, usage docs, and validation script together.

Development rules live in docs/development.md.