{
  "markdown": "# Honeydew AI Plugins for Coding Agents\n\nSkills and tools powered by the [Honeydew MCP](https://honeydew.ai/docs/integration/mcp) that help coding agents build semantic models and analyze data through natural conversation.\n\n## Example Use Cases\n\n**Query your data** — Ask \"Show me revenue by region for last quarter.\" Your coding agent discovers the right entities and metrics, runs the query through the semantic layer, and returns the results.\n\n**Build a semantic model** — Ask \"I added a new orders table — create an entity with revenue and order count metrics.\" Your coding agent imports the table, defines attributes and metrics following your naming conventions, and validates the result.\n\n**Investigate anomalies** — Ask \"Why did churn spike last month?\" Your coding agent runs a multi-step deep analysis, explores correlations across your model, and surfaces the key drivers with supporting data.\n\n## Prerequisites\n\n- A coding agent that supports plugins/skills (e.g., [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://developers.openai.com/codex/cli), [Cursor](https://cursor.com), [GitHub Copilot CLI](https://githubnext.com/projects/copilot-cli), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or any agent with MCP support)\n- A Honeydew AI workspace with the [Honeydew MCP server](https://honeydew.ai/docs/integration/mcp) configured\n\n## Installation\n\n### Claude Code\n\nAdd this marketplace to Claude Code:\n\n```\n/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins\n```\n\nThen install the plugin:\n\n```\n/plugin install honeydew-ai@honeydew-ai-claude-plugins\n```\n\nThen reload plugins to activate:\n\n```\n/reload-plugins\n```\n\n### Codex\n\nAdd this marketplace to Codex:\n\n```\ncodex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins\n```\n\nThen open the plugin directory and install the plugin:\n\n```\ncodex\n/plugins\n```\n\nIf the marketplace was already added before this repo exposed the Codex wrapper path, refresh it first:\n\n```\ncodex plugin marketplace upgrade honeydew-ai-coding-agents-plugins\n```\n\n### GitHub Copilot CLI\n\nAdd this marketplace to Copilot CLI:\n\n```\n/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins\n```\n\nThen install the plugin:\n\n```\n/plugin install honeydew-ai@honeydew-ai-github-copilot-plugins\n```\n\n### Cursor\n\n1. In your team or organization settings, go to [cursor.com/dashboard/plugins](https://cursor.com/dashboard/plugins) (or click **Plugins** on the left side menu).\n2. Scroll down to **Team Marketplaces** and click **Add Marketplace** (or select an existing one).\n3. Within the Marketplace, click **Add Plugin**, paste `https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins`, and click **Add 1 plugin**.\n4. Optionally, enable **auto-refresh** to get updates automatically.\n5. Go back to the plugins page, search for the Honeydew plugin, and click **Add**.\n\n### Gemini CLI\n\nInstall the Honeydew extension (skills + Honeydew MCP server):\n\n```bash\ngemini extensions install https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins\n```\n\n### Other Coding Agents\n\nFor coding agents that support MCP, configure the [Honeydew MCP server](https://honeydew.ai/docs/integration/mcp) and use the skill files in this repository as prompts or instructions. The skills are written as agent-agnostic markdown documentation that any coding agent can consume.\n\n## Updating an Installed Plugin\n\nInstalling pins the version you installed. Most agents keep a cached copy of the marketplace, so an update is two steps: refresh the marketplace, then update the plugin itself.\n\n### Claude Code\n\nIn a session, open the plugin manager and choose the update action:\n\n```\n/plugin\n```\n\nThen apply it:\n\n```\n/reload-plugins\n```\n\nOr from the shell — refresh the marketplace first, or the update will not see a new version:\n\n```bash\nclaude plugin marketplace update honeydew-ai-claude-plugins\nclaude plugin update honeydew-ai\n```\n\nRestart Claude Code to apply. `claude plugin list` shows the installed version.\n\n### Codex\n\nCodex has no plugin-level upgrade command. Refresh the marketplace snapshot, then re-add the plugin to pick up the new version:\n\n```bash\ncodex plugin marketplace upgrade honeydew-ai-coding-agents-plugins\ncodex plugin add honeydew-ai@honeydew-ai-coding-agents-plugins\n```\n\nThe `/plugins` menu inside a `codex` session does the same thing interactively.\n\n### GitHub Copilot CLI\n\nRefresh the marketplace catalog, then reinstall:\n\n```bash\ncopilot plugin marketplace update honeydew-ai-github-copilot-plugins\n```\n\n```\n/plugin install honeydew-ai@honeydew-ai-github-copilot-plugins\n```\n\n### Cursor\n\nIf you enabled **auto-refresh** on the marketplace at install time, updates arrive on their own. Otherwise, go back to [cursor.com/dashboard/plugins](https://cursor.com/dashboard/plugins), open the Team Marketplace holding the plugin, and refresh it — the plugin picks up the new version from there.\n\n### Gemini CLI\n\n```bash\ngemini extensions update honeydew-ai-tools\n```\n\n`gemini extensions update --all` updates every installed extension, and `gemini extensions list` shows the installed version. Installing with `gemini extensions install --auto-update` keeps it current without this step.\n\n### Other Coding Agents\n\nPull the latest skill files from your clone of this repository. Nothing is cached elsewhere — the skills are read from disk.\n\n## Available Skills\n\nThe `honeydew-ai` plugin includes 13 skills:\n\n| Skill | Description |\n|-------|-------------|\n| **model-exploration** | Explore the semantic model — list entities, search fields, inspect relationships, and discover warehouse tables |\n| **workspace-branch** | Manage workspaces and branches — set session context, create/delete branches, review branch history, and open pull requests |\n| **entity-creation** | Create entities — the foundational business concepts built from data warehouse tables |\n| **relation-creation** | Define relationships between entities with join types, cardinality, and complex join conditions |\n| **attribute-creation** | Create calculated attributes (dimensions) — per-row virtual columns defined with SQL expressions |\n| **metric-creation** | Create metrics (KPIs) — reusable aggregations like totals, averages, ratios, and growth rates |\n| **context-item-creation** | Create context items — instructions, skills, knowledge pointers, and memory events that give the AI analyst persistent knowledge about your organization |\n| **domain-creation** | Create domains — curated subsets of the semantic model exposed to specific teams or use cases |\n| **validation** | Mandatory post-creation validation — type-specific sanity checks, cross-validation, and error handling |\n| **query** | Query data using structured YAML perspectives, natural language questions, or multi-step deep analysis |\n| **query-debugging** | Review and inspect past query executions — what ran, from which client (BI tools, SQL interface, MCP, deep analysis), the semantic YAML and compiled SQL behind a run, and debugging failures |\n| **filtering** | Advanced filtering syntax — comparisons, string matching, date handling, nulls, and full-text search |\n| **conversation-review** | Bulk review past analysis conversations — categorize user feedback, build action items, and apply semantic/context layer improvements on a branch |\n\n## Supported Data Warehouses\n\n- Snowflake\n- Databricks\n- BigQuery\n\n## Building a Release\n\n### Claude-specific zip (claude.ai private marketplace)\n\nThe `honeydew-ai-claude-<version>.zip` artifact is used to install this plugin via the [claude.ai](https://claude.ai) web interface as a private marketplace plugin. It packages the plugin in the layout claude.ai expects: `.claude-plugin/plugin.json` at the zip root, alongside `.mcp.json`, `hooks/`, `assets/`, and all skill markdown files.\n\n**To install on claude.ai:**\n1. Download the zip — permanent link to the latest version:\n   `https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins/releases/latest/download/honeydew-ai-claude.zip`\n2. In claude.ai, go to **Settings → Plugins → Add plugin → Upload zip**\n3. Upload the zip — the plugin will appear in your private marketplace\n\nRelease zips are built automatically by CI and attached to each GitHub Release. To build one locally (e.g. for testing):\n\n```bash\n./scripts/build-release-claude.sh\n```\n\nThis generates `dist/honeydew-ai-claude-<version>.zip` from the repo root.\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE) for details.\n",
  "bytes": 8468,
  "sha": "820e28796568ef9fc0c7ad841b30bf475df5973957c5754ef141380cac03ef9d",
  "repo_slug": "honeydew-ai/honeydew-ai-coding-agents-plugins",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_honeydew_ai_honeydew_ai_coding_agents_pl_44c58fa1/readme"
}