Add Codex plugin#2987
Conversation
Appwrite WebsiteProject ID: Website (appwrite/website)Project ID: Tip Global CDN and DDoS protection come free with every Sites deployment |
Greptile SummaryThis PR adds the announcement blog post, changelog entry, and updated docs for the Appwrite plugin for Codex, which bundles agent skills and the Appwrite Docs MCP server into a single install.
Confidence Score: 4/5Content-only PR; safe to merge once the minor wording issues are resolved. All changes are Markdoc content with no functional logic. The info box in the docs promises manual skill-copying instructions but links to a section that only covers MCP servers, which could leave readers without the guidance they expect. A small grammar fix in the blog post heading is also needed. The info-box callout in src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc should either link to actual skill-copying instructions or rephrase to reflect what Step 3 actually covers. Important Files Changed
Reviews (1): Last reviewed commit: "Merge branch 'main' into add-codex-plugi..." | Re-trigger Greptile |
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
| - **The Appwrite Docs MCP server:** No credentials required. Codex can search the Appwrite documentation as it works, instead of relying on whatever it was trained on. | ||
| - **Thirteen agent skills:** Markdown skills covering the Appwrite CLI and every major Appwrite SDK (TypeScript, Dart, .NET, Go, Kotlin, PHP, Python, Ruby, Rust, and Swift), plus two guided deployment skills for shipping Appwrite Sites and Functions with the Appwrite CLI. Codex loads the relevant skill on its own when a task calls for it, and the deployment skills can also be invoked explicitly with `$appwrite-deploy-site` and `$appwrite-deploy-function`. | ||
|
|
||
| # Setup the plugin |
There was a problem hiding this comment.
| # Setup the plugin | |
| # Set up the plugin |
| {% info title="Prefer manual setup?" %} | ||
|
|
||
| If you'd rather copy skills and configure the MCP server yourself, skip to [Step 3](#step-3). | ||
|
|
||
| {% /info %} |
There was a problem hiding this comment.
The callout reads "If you'd rather copy skills and configure the MCP server yourself, skip to Step 3", but Step 3 only covers adding MCP servers manually — it has no instructions for manually copying skill files into ~/.codex/skills/. A reader who follows that link expecting to find skill setup will find nothing about it, which is especially surprising because the blog post explicitly mentions the old manual workflow of copying files into that directory.
| timeToRead: 4 | ||
| author: aditya-oberai | ||
| category: announcement | ||
| featured: false |
There was a problem hiding this comment.
Probably should have FAQ, especially around why API MCP is not supported. We do cover it in the article, but FAQs should be good here in frontmatter
| {% section #quick-start-prompts step=1 title="Quick start prompts" %} | ||
| {% section #install-plugin step=1 title="Install the Appwrite plugin" %} | ||
|
|
||
| The fastest way to get started with Appwrite in Codex is to install the **Appwrite plugin** from the Appwrite marketplace. The plugin includes agent skills for the Appwrite CLI and all major SDKs and registers the Appwrite Docs MCP server, giving Codex everything it needs to work with your Appwrite projects. |
There was a problem hiding this comment.
| The fastest way to get started with Appwrite in Codex is to install the **Appwrite plugin** from the Appwrite marketplace. The plugin includes agent skills for the Appwrite CLI and all major SDKs and registers the Appwrite Docs MCP server, giving Codex everything it needs to work with your Appwrite projects. | |
| The fastest way to get started with Appwrite in Codex is to install the **Appwrite plugin** from the Appwrite marketplace. The plugin includes agent skills for the Appwrite CLI and all major SDKs and registers the Appwrite Docs MCP server, giving Codex access to the Appwrite documentation so that it follows the latest and suggested code patterns. |
|
@adityaoberai I see we're using a PNG and the assets test is failing, let's also fix that. |
2 participants
What does this PR do?
Adds Codex plugin announcment, changelog, and updates docs
Test Plan
Visit
/blog/post/announcing-appwrite-codex-plugin,/docs/tooling/ai/ai-dev-tools/codex,/changelog/entry/2026-05-11Related PRs and Issues
Blocked by appwrite/codex-plugin#1
Have you read the Contributing Guidelines on issues?
Yes