← Files DexiARCHIVED FILE
README.md
2.99 KB · Nov 19, 2026 · 01:34 UTC
# Dexi plugin for ChatGPT and Codex
Connects ChatGPT and Codex to your [Dexi](https://dexi.net) notes via the Dexi MCP server (`https://mcp.dexi.net/mcp`). On first use, Dexi's OAuth consent page opens in your browser — sign in, choose what the connection can access (everything, or a single folder/tag), and you're connected.
This is the [Agent Plugins](https://agent-plugins.org) packaging of the same skills that ship in the [Claude Code plugin](https://github.com/dexi/claude-plugin); the three `SKILL.md` files are kept in sync by hand (provider-neutral wording, `name:` frontmatter, no Claude-only keys).
## Layout
```
plugin.json Agent Plugins manifest + OpenAI listing metadata (extensions.com.openai)
mcp.json the remote Dexi MCP server (streamable HTTP, OAuth 2.1)
skills/<name>/ SKILL.md + agents/openai.yaml (which MCP tools the skill depends on)
assets/ icon-128.png (composer icon), logo-512.png (listing logo)
build.sh zips the package for the OpenAI plugin portal → dist/
```
## What you get
- **The Dexi MCP server** — search, semantic search, note CRUD, tags, folders, bases, reviews, documented at [docs.dexi.net](https://docs.dexi.net/mcp/tools). The model uses them automatically once connected.
- **Capture** — save a finding, decision, or snippet from the current conversation as a Dexi note ("save that to my notes").
- **Recall** — search your notes (keyword + semantic) and answer from what you've saved ("did I save anything about X?").
- **Review** — a spaced-repetition review session: question-first quizzing on your due cards, grades recorded back to Dexi. Only runs when you ask for it.
## Install
**ChatGPT**: once the plugin is published, install "Dexi" from the ChatGPT plugin directory. Until then (or on a plan without the directory), add `https://mcp.dexi.net/mcp` as a custom MCP connector in developer mode — see [dexi.net/mcp/chatgpt](https://dexi.net/mcp/chatgpt).
**Codex**: from the public mirror,
```
codex plugin marketplace add dexi/openai-plugin
```
## Publishing (maintainers)
1. `./build.sh` → `dist/dexi-openai-plugin-<version>.zip` (bump `version` in `plugin.json` first; metadata, asset, and skill changes all need a new ZIP — MCP tool changes are re-scanned daily without one).
2. Upload at [platform.openai.com/plugins](https://platform.openai.com/plugins) → the Dexi plugin (or **Create plugin → With MCP** the first time), resolve the automated scan findings.
3. MCP tab → Connect: the portal issues a domain-verification token; set it as `OPENAI_APPS_CHALLENGE_TOKEN` on the `dexi-backend` Railway service so `https://mcp.dexi.net/.well-known/openai-apps-challenge` returns it, then verify.
4. Submit for review with the test cases, test account, and walkthrough video listed in the repo's `LISTINGS.md`.
## Access control
Manage or revoke the connection in Dexi under **Settings → Connected apps**, where you can also restrict it to one folder or tag after the fact.
## License
MIT — see [LICENSE](LICENSE).
SHA-256: ece04b411ee0bdf7b8dc346060fb2e167029e1f4c4630c046c54ff92ce1254e5