Appwrite Codex CLI Plugin

Appwrite tools for the OpenAI Codex CLI. This plugin packages Appwrite SDK skills, Appwrite deployment workflow skills, and the Appwrite docs MCP server.

Structure

plugins/appwrite/skills/                       # Codex skills (auto-loaded by description match)
|-- appwrite-typescript/SKILL.md
|-- appwrite-dart/SKILL.md
|-- appwrite-kotlin/SKILL.md
|-- appwrite-swift/SKILL.md
|-- appwrite-php/SKILL.md
|-- appwrite-python/SKILL.md
|-- appwrite-ruby/SKILL.md
|-- appwrite-go/SKILL.md
|-- appwrite-rust/SKILL.md
|-- appwrite-dotnet/SKILL.md
|-- appwrite-cli/SKILL.md
|-- appwrite-deploy-site/SKILL.md
`-- appwrite-deploy-function/SKILL.md
plugins/appwrite/.codex-plugin/plugin.json     # Codex plugin manifest
.agents/plugins/marketplace.json         # Local marketplace manifest
plugins/appwrite/.mcp.json                     # MCP server config for plugin installs
plugins/appwrite/config.toml                   # MCP server config snippet for manual installs

Installation

Codex plugins include a .codex-plugin/plugin.json manifest for plugin installation. For manual installs, Codex CLI loads skills from ~/.codex/skills/ and reads MCP server configuration from ~/.codex/config.toml. Install the generated files manually by copying them into those locations.

To install through a local Codex marketplace, add this directory as a marketplace source using the generated .agents/plugins/marketplace.json file.

macOS / Linux

# Copy skills
mkdir -p ~/.codex/skills
cp -R plugins/appwrite/skills/* ~/.codex/skills/

# Append the MCP config snippet to your Codex config
mkdir -p ~/.codex
cat plugins/appwrite/config.toml >> ~/.codex/config.toml

Windows (PowerShell)

# Copy skills
New-Item -ItemType Directory -Force -Path "$HOME\.codex\skills" | Out-Null
Copy-Item -Recurse plugins\appwrite\skills\* "$HOME\.codex\skills\"

# Append the MCP config snippet to your Codex config
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
Get-Content plugins\appwrite\config.toml | Add-Content "$HOME\.codex\config.toml"

Included Skills

Each skill ships as plugins/appwrite/skills/appwrite-<language>/SKILL.md. Codex loads them based on the description field in the frontmatter, so they activate automatically when a session is about Appwrite work in that language:

• appwrite-typescript
• appwrite-dart
• appwrite-kotlin
• appwrite-swift
• appwrite-php
• appwrite-python
• appwrite-ruby
• appwrite-go
• appwrite-rust
• appwrite-dotnet
• appwrite-cli
• appwrite-deploy-site
• appwrite-deploy-function

The language skills give Codex language-specific Appwrite context for authentication, database queries, storage, realtime, functions, and server-side administration. The deployment skills walk through Appwrite Sites and Functions deployment with the Appwrite CLI.

Deployment Workflows

Deployment workflows are exposed as explicit skills:

• $appwrite-deploy-site
• $appwrite-deploy-function

Use these to walk through deploying Appwrite sites and functions with the Appwrite CLI. Codex can also load them automatically when a task matches the skill description.

Included MCP Servers

The bundled plugins/appwrite/config.toml registers one MCP server:

• appwrite-docs proxies https://mcp-for-docs.appwrite.io through npx mcp-remote so Codex can search the Appwrite documentation.

Verify

After copying, run codex and check:

• A session about Appwrite TypeScript work loads the appwrite-typescript skill (visible in the session header).
• Typing $ lets you invoke the appwrite-deploy-* skills explicitly.
• codex mcp list (or codex --debug) lists the appwrite-docs server.

Contribution

This library is auto-generated by Appwrite custom SDK Generator. To learn more about how you can help us improve this SDK, please check the contribution guide before sending a pull-request.

License

Please see the BSD-3-Clause license file for more information.