@amsterdamdatalabs/enact-extensions 0.1.0

package/spec/codex.md

@@ -0,0 +1,145 @@
+# Plugins
+
+## Overview
+
+Plugins bundle skills, app integrations, and MCP servers into reusable
+workflows for Codex.
+
+Extend what Codex can do, for example:
+
+- Install the Gmail plugin to let Codex read and manage Gmail.
+- Install the Google Drive plugin to work across Drive, Docs, Sheets, and
+  Slides.
+- Install the Slack plugin to summarize channels or draft replies.
+
+A plugin can contain:
+
+- **Skills:** reusable instructions for specific kinds of work. Codex can load
+  them when needed so it follows the right steps and uses the right references
+  or helper scripts for a task.
+- **Apps:** connections to tools like GitHub, Slack, or Google Drive, so
+  Codex can read information from those tools and take actions in them.
+- **MCP servers:** services that give Codex access to additional tools or
+  shared information, often from systems outside your local project.
+
+More plugin capabilities are coming soon.
+
+## Use and install plugins
+
+### Plugin Directory in the Codex app
+
+Open **Plugins** in the Codex app to browse and install curated plugins.
+
+<CodexScreenshot
+  alt="Codex Plugins page"
+  lightSrc="/images/codex/plugins/directory.png"
+  darkSrc="/images/codex/plugins/directory_dark.png"
+/>
+
+### Plugin directory in the CLI
+
+In Codex CLI, run the following command to open the plugins list:
+
+```text
+codex
+/plugins
+```
+
+<CodexScreenshot
+  alt="Plugins list in Codex CLI"
+  lightSrc="/images/codex/plugins/cli_light.png"
+  darkSrc="/images/codex/plugins/codex-plugin-cli.png"
+/>
+
+The CLI plugin browser groups plugins by marketplace. Use the marketplace tabs
+to switch sources, open a plugin to inspect details, install or uninstall
+marketplace entries, and press <kbd>Space</kbd> on an installed plugin to toggle
+its enabled state.
+
+### Install and use a plugin
+
+Once you open the plugin directory:
+
+<WorkflowSteps>
+
+1. Search or browse for a plugin, then open its details.
+2. Select the install button. In the app, select the plus button or
+   **Add to Codex**. In the CLI, select `Install plugin`.
+3. If the plugin needs an external app, connect it when prompted. Some plugins
+   ask you to authenticate during install. Others wait until the first time you
+   use them.
+4. After installation, start a new thread and ask Codex to use the plugin.
+
+</WorkflowSteps>
+
+After you install a plugin, you can use it directly in the prompt window:
+
+<CodexScreenshot
+  alt="Codex Plugins page"
+  lightSrc="/images/codex/plugins/plugin-github-invoke.png"
+  darkSrc="/images/codex/plugins/plugin-github-invoke-dark.png"
+/>
+
+<div class="not-prose mt-4 grid gap-4 md:grid-cols-2">
+  <div class="rounded-xl border border-subtle bg-surface px-5 py-4">
+    <p class="text-sm font-semibold text-default">Describe the task directly</p>
+    <p class="mt-2 text-sm text-secondary">
+      Ask for the outcome you want, such as "Summarize unread Gmail threads
+      from today" or "Pull the latest launch notes from Google Drive."
+    </p>
+    <p class="mt-3 text-sm text-secondary">
+      Use this when you want Codex to choose the right installed tools for the
+      task.
+    </p>
+  </div>
+
+  <div class="rounded-xl border border-subtle bg-surface px-5 py-4">
+    <p class="text-sm font-semibold text-default">Choose a specific plugin</p>
+    <p class="mt-2 text-sm text-secondary">
+      Type <code>@</code> to invoke the plugin or one of its bundled skills
+      explicitly.
+    </p>
+    <p class="mt-3 text-sm text-secondary">
+      Use this when you want to be specific about which plugin or skill Codex
+      should use. See <a href="/codex/app/commands">Codex app commands</a> and{" "}
+      <a href="/codex/skills">Skills</a>.
+    </p>
+  </div>
+</div>
+
+### How permissions and data sharing work
+
+Installing a plugin makes its workflows available in Codex, but your existing
+[approval settings](https://developers.openai.com/codex/agent-approvals-security) still apply. Any
+connected external services remain subject to their own authentication,
+privacy, and data-sharing policies.
+
+- Bundled skills are available as soon as you install the plugin.
+- If a plugin includes apps, Codex may prompt you to install or sign in to
+  those apps in ChatGPT during setup or the first time you use them.
+- If a plugin includes MCP servers, they may require additional setup or
+  authentication before you can use them.
+- When Codex sends data through a bundled app, that app's terms and privacy
+  policy apply.
+
+### Remove or turn off a plugin
+
+To remove a plugin, reopen it from the plugin browser and select
+**Uninstall plugin**.
+
+Uninstalling a plugin removes the plugin bundle from Codex, but bundled apps
+stay installed until you manage them in ChatGPT.
+
+If you want to keep a plugin installed but turn it off, set its entry in
+`~/.codex/config.toml` to `enabled = false`, then restart Codex:
+
+```toml
+[plugins."gmail@openai-curated"]
+enabled = false
+```
+
+## Build your own plugin
+
+If you want to create, test, or distribute your own plugin, see
+[Build plugins](https://developers.openai.com/codex/plugins/build). That page covers local scaffolding,
+manual marketplace setup, plugin manifests, and packaging guidance.

package/spec/cursor.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "cursor-plugin.json",
+  "title": "Cursor Plugin Manifest",
+  "description": "Validates .cursor-plugin/plugin.json for Cursor plugins. Components (rules/, skills/, agents/, commands/, mcp.json, hooks/) are auto-discovered from default directories.",
+  "type": "object",
+  "required": ["name"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Unique plugin identifier and skill namespace prefix.",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version (MAJOR.MINOR.PATCH).",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string",
+      "description": "Short description shown in the Cursor Marketplace."
+    },
+    "author": {
+      "type": "object",
+      "required": ["name"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "email": { "type": "string", "format": "email" },
+        "url": { "type": "string", "format": "uri" }
+      }
+    },
+    "homepage": {
+      "type": "string",
+      "format": "uri",
+      "description": "Plugin or developer homepage URL."
+    },
+    "repository": {
+      "type": "string",
+      "description": "URL to the source repository (must be public for marketplace submission)."
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier (must be open source for marketplace submission)."
+    },
+    "keywords": {
+      "type": "array",
+      "items": { "type": "string" },
+      "uniqueItems": true,
+      "description": "Discovery tags for the Cursor Marketplace."
+    },
+    "logo": {
+      "type": "string",
+      "description": "Relative path to logo image (PNG/SVG) or absolute URL."
+    },
+    "rules": {
+      "type": "string",
+      "description": "Custom path to rules directory (.mdc files for persistent AI guidance).",
+      "default": "./rules/"
+    },
+    "skills": {
+      "type": "string",
+      "description": "Custom path to skills directory.",
+      "default": "./skills/"
+    },
+    "agents": {
+      "type": "string",
+      "description": "Custom path to agents directory.",
+      "default": "./agents/"
+    },
+    "commands": {
+      "type": "string",
+      "description": "Custom path to commands directory.",
+      "default": "./commands/"
+    },
+    "mcpServers": {
+      "type": "string",
+      "description": "Custom path to mcp.json MCP server configuration.",
+      "default": "./mcp.json"
+    },
+    "hooks": {
+      "type": "string",
+      "description": "Custom path to hooks directory or configuration.",
+      "default": "./hooks/"
+    }
+  }
+}

package/spec/cursor.md

@@ -0,0 +1,175 @@
+> **Source:** [Cursor Plugins documentation](https://cursor.com/docs/plugins)  
+> **Also available as:** [plugins.md](https://cursor.com/docs/plugins.md)  
+> **Full reference:** [Plugins reference](https://cursor.com/docs/reference/plugins.md)
+
+# Plugins
+
+Plugins package rules, skills, agents, commands, MCP servers, and hooks into distributable bundles. Browse official plugins in the [Cursor Marketplace](https://cursor.com/marketplace). For community plugins and MCP servers, browse [cursor.directory](https://cursor.directory/). You can also [build your own](https://cursor.com/docs/plugins#creating-plugins) to share with other developers.
+
+## What plugins contain
+
+A plugin can bundle any combination of these components:
+
+| Component       | Description                                                |
+| :-------------- | :--------------------------------------------------------- |
+| **Rules**       | Persistent AI guidance and coding standards (`.mdc` files) |
+| **Skills**      | Specialized agent capabilities for complex tasks           |
+| **Agents**      | Custom agent configurations and prompts                    |
+| **Commands**    | Agent-executable command files                             |
+| **MCP Servers** | Model Context Protocol integrations                        |
+| **Hooks**       | Automation scripts triggered by events                     |
+
+## The marketplace
+
+The [Cursor Marketplace](https://cursor.com/marketplace) is where you discover and install official plugins. Plugins are distributed as Git repositories and submitted through the Cursor team. Every plugin is [manually reviewed](https://cursor.com/help/security-and-privacy/marketplace-security) before it's listed. Browse official plugins at [cursor.com/marketplace](https://cursor.com/marketplace) or search by keyword in the marketplace panel. For community plugins and MCP servers, browse [cursor.directory](https://cursor.directory/).
+
+## Team marketplaces
+
+Team marketplaces are available on Teams and Enterprise plans.
+
+- **Teams plan:** up to 1 team marketplace
+- **Enterprise plan:** unlimited team marketplaces
+
+[Contact sales](https://cursor.com/contact-sales?source=docs-plugins) for unlimited team marketplaces and Enterprise admin controls.
+
+The **Team Marketplaces** section appears below **Plugins** in dashboard settings.
+
+On Enterprise plans, only admins can add team marketplaces from **Dashboard → Settings → Plugins**.
+
+### Required vs optional plugins
+
+When you assign a plugin to a distribution group, you can set it as required or optional:
+
+- **Required:** After you click **Save**, the plugin is installed automatically for everyone in that distribution group.
+- **Optional:** The plugin is available to everyone in that distribution group, and each developer can choose whether to install it.
+
+### How do distribution groups work with SCIM?
+
+Distribution groups can be controlled with [SCIM](https://cursor.com/docs/account/teams/scim)-synced directory groups. If your organization uses SCIM, manage group membership in your identity provider, and Cursor will sync those group updates.
+
+## Add a team marketplace
+
+Use this flow to import a GitHub repository as a team marketplace:
+
+1. Go to **Dashboard → Settings → Plugins**.
+2. In **Team Marketplaces**, click **Import**.
+3. Paste the GitHub repository URL and continue.
+4. Review the parsed plugins. Optionally set Team Access groups, then continue.
+5. Set the marketplace name and description, then save.
+
+Example repository to try:
+
+- [fieldsphere/cursor-team-marketplace-template](https://github.com/fieldsphere/cursor-team-marketplace-template)
+
+## Where developers find team marketplaces
+
+Developers can find team marketplaces in the marketplace panel in Cursor.
+
+- Open the marketplace panel in Cursor.
+- Look for plugins from your team marketplace.
+- Install optional plugins directly from that panel.
+- Required plugins are installed automatically when admins save the required setting for your distribution group.
+
+## Installing plugins
+
+Install plugins from the marketplace. Plugins can be scoped to a project or installed at the user level.
+
+### MCP Apps deeplinks
+
+Share MCP server configurations using install links:
+
+```text
+cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG
+```
+
+See [MCP install links](https://cursor.com/docs/mcp/install-links) for details on generating these links.
+
+## Managing installed plugins
+
+### MCP servers
+
+Toggle MCP servers on or off from Cursor Settings:
+
+1. Open Settings (Cmd+Shift+J)
+2. Go to **Features → Model Context Protocol**
+3. Click the toggle next to any server
+
+Disabled servers won't load or appear in chat.
+
+### Rules and skills
+
+Manage rules and skills from the Rules section of Cursor Settings. Toggle individual rules between **Always**, **Agent Decides**, and **Manual** modes. Skills appear in the **Agent Decides** section and can be invoked manually with `/skill-name` in chat.
+
+## Using the workspaceOpen hook
+
+A `workspaceOpen` hook can return plugin paths to load on workspace open, which is useful when the set of plugins depends on the workspace itself.
+
+### Hooks reference
+
+Register plugin paths from a `workspaceOpen` hook script. See the [Hooks reference](https://cursor.com/docs/reference/plugins) for hook script details.
+
+## Creating plugins
+
+A plugin is a directory with a `.cursor-plugin/plugin.json` manifest and your components (rules, skills, agents, commands, hooks, or MCP servers). Start from the [plugin template repository](https://github.com/cursor/plugin-template) or create one from scratch:
+
+```text
+my-plugin/
+├── .cursor-plugin/
+│   └── plugin.json
+├── rules/
+│   └── coding-standards.mdc
+├── skills/
+│   └── code-reviewer/
+│       └── SKILL.md
+└── mcp.json
+```
+
+The manifest only requires a `name` field. Components are discovered automatically from their default directories, or you can specify custom paths in the manifest.
+
+```json
+{
+  "name": "my-plugin",
+  "description": "Custom development tools",
+  "version": "1.0.0",
+  "author": { "name": "Your Name" }
+}
+```
+
+### Test plugins locally
+
+Before you publish, load your plugin from `~/.cursor/plugins/local`:
+
+1. Create a folder for your plugin: `~/.cursor/plugins/local/my-plugin`
+2. Copy your plugin files into that folder. Make sure `.cursor-plugin/plugin.json` is at the plugin root.
+3. Restart Cursor, or run **Developer: Reload Window**.
+4. Verify your plugin components load in Cursor, such as rules, skills, or MCP servers.
+
+For faster iteration, symlink your plugin repository:
+
+```bash
+ln -s /path/to/my-plugin ~/.cursor/plugins/local/my-plugin
+```
+
+When your plugin is ready, submit it for review at [cursor.com/marketplace/publish](https://cursor.com/marketplace/publish). For multi-plugin repositories, add a marketplace manifest at `.cursor-plugin/marketplace.json`.
+
+See the [Plugins reference](https://cursor.com/docs/reference/plugins) for the full manifest schema, component formats, and submission checklist.
+
+### Team and Enterprise marketplaces
+
+Upgrade for private team marketplaces and organization-wide plugin distribution.
+
+## FAQ
+
+### Are marketplace plugins reviewed for security?
+
+Yes. Every plugin is manually reviewed before it's listed. All plugins must be open source, and we review each update before publishing. See [Marketplace security](https://cursor.com/help/security-and-privacy/marketplace-security) for details on vetting, update reviews, and how to report issues.
+
+### How do I create a plugin?
+
+Create a directory with a `.cursor-plugin/plugin.json` manifest file, add your rules, skills, agents, commands, or other components, and submit it to the Cursor team. See the [Plugins reference](https://cursor.com/docs/reference/plugins) for the full guide.
+
+---
+
+## Related documentation
+
+- [Overview of all docs pages](https://cursor.com/llms.txt) — documentation index for discovery

package/spec/enact.json

@@ -0,0 +1,211 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "enact-plugin.json",
+  "title": "Enact Plugin Manifest",
+  "description": "Validates .agents/plugin.json — the canonical Enact plugin format. Superset of the Codex format with explicit component paths, slash commands, multi-platform targets, and Enact Factory integration fields.",
+  "type": "object",
+  "required": ["name"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Unique plugin identifier. Used as the skill namespace prefix across all target platforms.",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version (MAJOR.MINOR.PATCH).",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string",
+      "description": "Short description shown in the Enact plugin registry."
+    },
+    "author": {
+      "type": "object",
+      "required": ["name"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "email": { "type": "string", "format": "email" },
+        "url": { "type": "string", "format": "uri" }
+      }
+    },
+    "homepage": {
+      "type": "string",
+      "format": "uri",
+      "description": "Plugin or developer homepage URL."
+    },
+    "repository": {
+      "type": "string",
+      "description": "URL to the source repository."
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier or UNLICENSED."
+    },
+    "keywords": {
+      "type": "array",
+      "items": { "type": "string" },
+      "uniqueItems": true,
+      "description": "Discovery tags for the Enact plugin registry."
+    },
+    "targets": {
+      "type": "array",
+      "description": "Agent platforms this plugin is built for. Drives platform-specific manifest generation.",
+      "items": {
+        "type": "string",
+        "enum": ["claude", "codex", "cursor"]
+      },
+      "uniqueItems": true,
+      "minItems": 1
+    },
+    "skills": {
+      "type": "string",
+      "description": "Relative path to the skills directory.",
+      "default": "./skills/"
+    },
+    "agents": {
+      "type": "string",
+      "description": "Relative path to the agents directory.",
+      "default": "./agents/"
+    },
+    "commands": {
+      "type": "string",
+      "description": "Relative path to the commands directory (flat Markdown files).",
+      "default": "./commands/"
+    },
+    "hooks": {
+      "type": "string",
+      "description": "Relative path to the hooks configuration file.",
+      "default": "./hooks/hooks.json"
+    },
+    "mcpServers": {
+      "type": "string",
+      "description": "Relative path to the .mcp.json MCP server configuration file.",
+      "default": "./.mcp.json"
+    },
+    "apps": {
+      "type": "string",
+      "description": "Relative path to the .app.json app connections file (Codex target only).",
+      "default": "./.app.json"
+    },
+    "lsp": {
+      "type": "string",
+      "description": "Relative path to the .lsp.json LSP server configuration (Claude target only).",
+      "default": "./.lsp.json"
+    },
+    "monitors": {
+      "type": "string",
+      "description": "Relative path to monitors configuration file (Claude target only).",
+      "default": "./monitors/monitors.json"
+    },
+    "settings": {
+      "type": "string",
+      "description": "Relative path to default settings applied when the plugin is enabled.",
+      "default": "./settings.json"
+    },
+    "bin": {
+      "type": "string",
+      "description": "Relative path to executables added to the Bash PATH while the plugin is active.",
+      "default": "./bin/"
+    },
+    "interface": {
+      "type": "object",
+      "description": "Display metadata for the Enact plugin registry and Codex plugin directory UI.",
+      "required": ["displayName", "shortDescription"],
+      "additionalProperties": false,
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Human-readable plugin name shown in the UI."
+        },
+        "shortDescription": {
+          "type": "string",
+          "description": "One-line description for plugin cards.",
+          "maxLength": 120
+        },
+        "longDescription": {
+          "type": "string",
+          "description": "Full description shown on the plugin detail page."
+        },
+        "developerName": {
+          "type": "string",
+          "description": "Developer or organization name displayed in the UI."
+        },
+        "category": {
+          "type": "string",
+          "description": "Plugin category for registry filtering.",
+          "enum": [
+            "Developer Tools",
+            "Productivity",
+            "Communication",
+            "Data",
+            "Finance",
+            "Design",
+            "Other"
+          ]
+        },
+        "composerIcon": {
+          "type": "string",
+          "description": "Relative path to a small composer icon (PNG, recommended ≤256×256 px)."
+        },
+        "logo": {
+          "type": "string",
+          "description": "Relative path to the full logo image (PNG)."
+        },
+        "capabilities": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Human-readable list of capabilities shown in the registry."
+        }
+      }
+    },
+    "factory": {
+      "type": "object",
+      "description": "Enact Factory integration settings.",
+      "additionalProperties": false,
+      "properties": {
+        "firstParty": {
+          "type": "boolean",
+          "description": "Marks this as a first-party Enact Factory plugin. Enables elevated trust in the factory runtime.",
+          "default": false
+        },
+        "bundledMcpProviders": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "MCP provider names that this plugin delegates heavy behavior to (e.g. enact-context, enact-wiki).",
+          "uniqueItems": true
+        },
+        "operatorScope": {
+          "type": "string",
+          "description": "Factory operator scope this plugin operates within.",
+          "enum": ["global", "project", "session"]
+        }
+      }
+    },
+    "operator": {
+      "type": "object",
+      "description": "Enact Operator operator integration settings.",
+      "additionalProperties": false,
+      "properties": {
+        "firstParty": {
+          "type": "boolean",
+          "description": "Marks this as a first-party Enact Operator plugin. Enables elevated trust in the operator runtime.",
+          "default": false
+        },
+        "bundledMcpProviders": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "MCP provider names that this plugin delegates heavy behaviour to (e.g. enact-context, enact-wiki).",
+          "uniqueItems": true
+        },
+        "operatorScope": {
+          "type": "string",
+          "description": "Operator scope this plugin operates within.",
+          "enum": ["global", "project", "session"]
+        }
+      }
+    }
+  }
+}