From e0b87f782606838fc298399c5b7e3c01b389e630 Mon Sep 17 00:00:00 2001 From: atharvadeosthale Date: Wed, 29 Jul 2026 12:04:49 +0000 Subject: [PATCH] chore: update CodexPlugin SDK to 0.2.0 --- README.md | 22 ++++++++---- plugins/appwrite/.codex-plugin/plugin.json | 8 ++--- plugins/appwrite/.mcp.json | 4 +-- plugins/appwrite/config.toml | 5 ++- plugins/appwrite/skills/appwrite-cli/SKILL.md | 34 +++++++++---------- 5 files changed, 41 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 36445ba..67bdb0e 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,11 @@ # Appwrite Codex CLI Plugin ![License](https://img.shields.io/github/license/appwrite/codex-plugin.svg?style=flat-square) -![Version](https://img.shields.io/badge/api%20version-0.1.1-blue.svg?style=flat-square) +![Version](https://img.shields.io/badge/api%20version-0.2.0-blue.svg?style=flat-square) [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite) [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord) -Appwrite tools for the [OpenAI Codex CLI](https://github.com/openai/codex). This plugin packages Appwrite SDK skills, Appwrite deployment workflow skills, and the Appwrite docs MCP server. +Appwrite tools for the [OpenAI Codex CLI](https://github.com/openai/codex). This plugin packages Appwrite SDK skills, Appwrite deployment workflow skills, and the hosted Appwrite MCP server. ## Structure @@ -89,11 +89,21 @@ Deployment workflows are exposed as explicit skills: 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 +## Hosted MCP Server -The bundled `plugins/appwrite/config.toml` registers one 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. -- `appwrite-docs` proxies `https://mcp-for-docs.appwrite.io` through `npx mcp-remote` so Codex can search the 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: + +```sh +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 @@ -101,7 +111,7 @@ 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. +- `codex mcp list` (or `codex --debug`) lists the `appwrite` server. ## Contribution diff --git a/plugins/appwrite/.codex-plugin/plugin.json b/plugins/appwrite/.codex-plugin/plugin.json index 03b2622..f8801a6 100644 --- a/plugins/appwrite/.codex-plugin/plugin.json +++ b/plugins/appwrite/.codex-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "appwrite", - "version": "0.1.1", - "description": "Appwrite tools for Codex, including SDK skills, MCP servers, and deployment workflow skills.", + "version": "0.2.0", + "description": "Appwrite tools for Codex, including SDK skills, the hosted Appwrite MCP server, and deployment workflow skills.", "author": { "name": "Appwrite", "email": "team@appwrite.io", @@ -20,8 +20,8 @@ "mcpServers": "./.mcp.json", "interface": { "displayName": "Appwrite", - "shortDescription": "Appwrite SDK skills, MCP servers, and deployment workflow skills for Codex.", - "longDescription": "Use Appwrite with Codex through language-specific SDK skills, project and documentation MCP servers, and guided deployment skills for sites and functions.", + "shortDescription": "Appwrite SDK skills, hosted MCP tools, and deployment workflow skills for Codex.", + "longDescription": "Use Appwrite with Codex through language-specific SDK skills, the OAuth-enabled hosted MCP server, and guided deployment skills for sites and functions.", "developerName": "Appwrite", "category": "Developer Tools", "capabilities": [ diff --git a/plugins/appwrite/.mcp.json b/plugins/appwrite/.mcp.json index a533647..abec78b 100644 --- a/plugins/appwrite/.mcp.json +++ b/plugins/appwrite/.mcp.json @@ -1,8 +1,8 @@ { "mcpServers": { - "appwrite-docs": { + "appwrite": { "type": "http", - "url": "https://mcp-for-docs.appwrite.io" + "url": "https://mcp.appwrite.io/" } } } diff --git a/plugins/appwrite/config.toml b/plugins/appwrite/config.toml index 0815586..e99a777 100644 --- a/plugins/appwrite/config.toml +++ b/plugins/appwrite/config.toml @@ -2,6 +2,5 @@ # # Merge the contents of this file into your ~/.codex/config.toml. -[mcp_servers.appwrite-docs] -command = "npx" -args = ["mcp-remote", "https://mcp-for-docs.appwrite.io"] +[mcp_servers.appwrite] +url = "https://mcp.appwrite.io/" diff --git a/plugins/appwrite/skills/appwrite-cli/SKILL.md b/plugins/appwrite/skills/appwrite-cli/SKILL.md index f53dedb..798ba8e 100644 --- a/plugins/appwrite/skills/appwrite-cli/SKILL.md +++ b/plugins/appwrite/skills/appwrite-cli/SKILL.md @@ -442,17 +442,17 @@ appwrite push tables | Command | Description | |---------|-------------| -| `appwrite tables-db list-tables --database-id ` | List tables | -| `appwrite tables-db create-table --database-id ` | Create table | -| `appwrite tables-db get-table --database-id --table-id ` | Get table | -| `appwrite tables-db update-table --database-id --table-id ` | Update table | -| `appwrite tables-db delete-table --database-id --table-id ` | Delete table | -| `appwrite tables-db list-columns --database-id --table-id ` | List columns | -| `appwrite tables-db get-column --database-id --table-id --key ` | Get column | -| `appwrite tables-db delete-column --database-id --table-id --key ` | Delete column | -| `appwrite tables-db list-column-indexes --database-id --table-id ` | List indexes | -| `appwrite tables-db create-column-index --database-id --table-id ` | Create index | -| `appwrite tables-db delete-column-index --database-id --table-id --key ` | Delete index | +| `appwrite tablesdb list-tables --database-id ` | List tables | +| `appwrite tablesdb create-table --database-id ` | Create table | +| `appwrite tablesdb get-table --database-id --table-id ` | Get table | +| `appwrite tablesdb update-table --database-id --table-id ` | Update table | +| `appwrite tablesdb delete-table --database-id --table-id ` | Delete table | +| `appwrite tablesdb list-columns --database-id --table-id ` | List columns | +| `appwrite tablesdb get-column --database-id --table-id --key ` | Get column | +| `appwrite tablesdb delete-column --database-id --table-id --key ` | Delete column | +| `appwrite tablesdb list-column-indexes --database-id --table-id ` | List indexes | +| `appwrite tablesdb create-column-index --database-id --table-id ` | Create index | +| `appwrite tablesdb delete-column-index --database-id --table-id --key ` | Delete index | ### Column type commands @@ -474,23 +474,23 @@ appwrite push tables | `create-enum-column` | Enum column (whitelist of accepted values) | | `create-relationship-column` | Relationship column | -All column commands use `appwrite tables-db --database-id --table-id `. +All column commands use `appwrite tablesdb --database-id --table-id `. ### Row operations ```bash # Create a row -appwrite tables-db create-row \ +appwrite tablesdb create-row \ --database-id "" --table-id "" \ --row-id 'unique()' --data '{ "title": "Hello World" }' \ --permissions 'read("any")' 'write("team:abc")' # List rows (JSON output) -appwrite tables-db list-rows \ +appwrite tablesdb list-rows \ --database-id "" --table-id "" --json # Get a row -appwrite tables-db get-row \ +appwrite tablesdb get-row \ --database-id "" --table-id "" --row-id "" ``` @@ -499,7 +499,7 @@ appwrite tables-db get-row \ Use `--where`, `--sort-asc`, `--sort-desc`, `--limit`, `--offset`, `--cursor-after`, and `--cursor-before` on list commands. Row and document list/get commands also support repeated `--select` flags. ```bash -appwrite tables-db list-rows \ +appwrite tablesdb list-rows \ --database-id "" \ --table-id "" \ --where 'status=active' \ @@ -805,7 +805,7 @@ appwrite users list --json appwrite users list --verbose # View a row in the Console -appwrite tables-db get-row \ +appwrite tablesdb get-row \ --database-id "" \ --table-id "" \ --row-id "" \