Appwrite Codex CLI Plugin

Appwrite tools for the OpenAI Codex CLI. This plugin packages Appwrite SDK skills, Appwrite deployment workflow skills, and the hosted Appwrite 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.

Hosted MCP Server

The bundled plugin and plugins/appwrite/config.toml register one appwrite server at https://mcp.appwrite.io/. It provides tools for working with your Appwrite workspace and projects and for searching the latest Appwrite documentation.

The hosted server uses browser-based OAuth, so no API key, project ID, endpoint, or other manually configured secret is required. After installing the plugin or merging the manual configuration, authenticate with:

codex mcp login appwrite

Then try:

Use Appwrite to show my workspace context and list my projects.

If the browser does not open, use the authorization URL printed by Codex. Run codex mcp logout appwrite followed by codex mcp login appwrite to refresh the OAuth session, and use codex mcp get appwrite to inspect the server configuration and status.

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 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.