Skip to content

Latest commit

 

History

History
131 lines (99 loc) · 5.74 KB

README.md

File metadata and controls

131 lines (99 loc) · 5.74 KB

Appwrite Cursor Plugin

License Version X Account Discord

Appwrite tools for Cursor. This plugin packages Appwrite SDK skills, the hosted Appwrite MCP server, and deployment commands.

Installation

Install the plugin from the Cursor Marketplace:

  1. Open Customize in the Cursor sidebar.
  2. Search for Appwrite.
  3. Select Install and choose a project or user scope.

To try a local copy instead, clone this repository into ~/.cursor/plugins/local/appwrite and run Developer: Reload Window. A marketplace install with the same plugin name takes precedence over the local copy.

Skills

The plugin includes Appwrite skills for the following languages and tools:

  • TypeScript: appwrite-typescript
  • Dart: appwrite-dart
  • Kotlin: appwrite-kotlin
  • Swift: appwrite-swift
  • PHP: appwrite-php
  • Python: appwrite-python
  • Ruby: appwrite-ruby
  • Go: appwrite-go
  • Rust: appwrite-rust
  • .NET: appwrite-dotnet
  • CLI: appwrite-cli

Each skill gives the agent Appwrite context for authentication, database operations, file storage, realtime subscriptions, functions, and more. Cursor loads a skill when a task matches its description.

Code review skills

These skills work with Appwrite Review, which reviews GitHub pull requests and grades them from S to F.

Skill What it does
appwrite-review-status Read the current tier, open findings, and filtered-out comments. Does not start a review.
appwrite-review-loop Fix the pull request until Appwrite Review grades it Tier S and no comments are left open.
appwrite-review-learn Reply on a finding with a lasting rule so Appwrite Review remembers it.
appwrite-review-setup Write .hansi.json and open a pull request onto the base branch.
appwrite-review-threads Applies on its own: do not resolve Appwrite Review's threads.

The review-threads rule says the same for every chat: Appwrite Review clears its threads itself after a fix or a dismissal.

The review skills need Appwrite Review set up on the repository (Console → your project → Review) and a way to talk to GitHub; the examples use the GitHub CLI. Each review counts toward the project's review usage, and review-loop stops after 5 iterations.

Commands

Agent-executable commands for deploying from your editor:

  • deploy-site: Deploy an Appwrite site with the Appwrite CLI. Covers init, push, non-interactive CI/CD mode, site management, variables, and logs.
  • deploy-function: Deploy an Appwrite function with the Appwrite CLI. Covers init, push, non-interactive CI/CD mode, function management, executions, variables, and local development.

Hosted MCP server

The plugin configures the hosted Appwrite MCP server at https://mcp.appwrite.io/ under the name appwrite. It gives Cursor access to your Appwrite organizations and projects, and to the latest Appwrite documentation.

Cursor starts a browser-based OAuth flow when the server first connects. Sign in to Appwrite and approve access; no API key, project ID, endpoint, or other secret needs to be added to .mcp.json.

After authentication, try:

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

If the server does not connect, open Customize, turn the appwrite MCP server off and on again, and complete the sign-in prompt. Do the same when the OAuth session expires, and check Cursor's MCP output logs for connection errors.

Structure

.cursor-plugin/
└── plugin.json              # Plugin manifest
skills/                      # Agent skills
├── 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-review-status/
│   └── SKILL.md
├── appwrite-review-loop/
│   └── SKILL.md
├── appwrite-review-learn/
│   └── SKILL.md
├── appwrite-review-setup/
│   └── SKILL.md
└── appwrite-review-threads/
    └── SKILL.md
rules/                       # Always-applied rules
└── review-threads.mdc
commands/                    # Agent-executable commands
├── deploy-site.md
└── deploy-function.md
.mcp.json                    # Hosted Appwrite MCP server

Learn more

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.