{
  "markdown": "# Alation Plugin\n\nAI coding agent plugin for the Alation platform. Query data products, explore catalogs, automate workflows, curate metadata, and configure AI agents — all through natural language.\n\nThe latest plugin is always available from the [Releases](https://github.com/Alation/alation-plugins/releases/latest) page.\n\n## Prerequisites\n\n- Python 3.10+\n- An Alation instance with OAuth client registration (see Step 2 below)\n\n## Getting Started\n\n### Step 1: Install the Plugin\n\n#### Claude Code\n\nRegister the marketplace and install:\n```\n/plugin marketplace add Alation/alation-plugins\n/plugin install alation@alation-plugins\n```\n\n#### Claude Cowork\n##### Marketplace\n1. Go to \"Customize\" in the sidebar.\n2. Click the \"+\" icon next to \"Personal Plugins\" and select \"Add marketplace\"\n3. Add marketplace by URL: `https://github.com/Alation/alation-plugins`\n4. Install `Alation`\n\n> _Note: After adding a marketplace, you can check for updates or re-install plugins by clicking the \"+\" icon next to \"Personal Plugins\" and selecting \"Browse Plugins\", then navigating to the \"Personal\" tab and selecting the `alation-plugins` marketplace_\n\n##### Zip File\n1. Download `alation.zip` from the [latest release](https://github.com/Alation/alation-plugins/releases/latest).\n2. Go to **Customize** in the sidebar.\n3. Click the \"+\" icon next to \"Presonal Plugins\" and select \"Upload plugin\"\n4. Drag and drop or browse files to the downloaded zip file to install\n\n#### Codex Plugin\n\nRegister the marketplace and install:\n```bash\ncodex plugin marketplace add https://github.com/Alation/alation-plugins.git\ncodex plugin add alation@alation-plugins\n```\n\nOn first use, ask Codex to set up Alation. Codex will prompt for your Alation\nbase URL and OAuth client ID, then use a manual OAuth flow where you open an\nauthorization URL and paste the final redirect URL back into chat. Depending on\nyour Codex sandbox settings, the CLI may ask for approval before making network\nrequests to your Alation instance.\n\n#### Codex Agent Skills / Gemini CLI\n\nInstall skills using the agent skills installer:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Alation/alation-plugins/main/bin/install-agent-skills.sh | bash -s -- --scope user\n```\n\nThis installs portable agent skills to `~/.agents/skills/`, which both Codex and Gemini CLI read automatically.\nEach skill bundles the Alation CLI — no separate installation needed.\n\nTo install to the current project only:\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Alation/alation-plugins/main/bin/install-agent-skills.sh | bash -s -- --scope workspace\n```\n\n#### Snowflake Cortex Code\n\nInstall agent skills the same way as Codex / Gemini CLI above, then register the skills directory with Cortex:\n\n```bash\ncortex skill add ~/.agents/skills\n```\n\nVerify the skills are available:\n```bash\ncortex skill list\n```\n\n#### Other Platforms\n\nAny agent that supports the [Agent Skills](https://agentskills.io) format can use Alation skills.\nRun the install script above with `--scope user` or `--scope workspace` and point your agent at the resulting `.agents/skills/` directory.\n\n### Step 2: Register an OAuth Client\n\nThe plugin uses OAuth to connect to your Alation instance. You (or an admin of your instance) will need to register an OAuth client if one doesn't exist already.\n\n1. Follow the instructions in [these docs](https://alation.github.io/agent-studio-docs/guides/authentication/user-initiated-auth/).\n2. Set the \"Client Type\" to `public`.\n3. Add `http://127.0.0.1:18722/callback` as an allowed redirect URL.\n4. Save the **client ID** — you'll need it in the next step.\n\n### Step 3: Authenticate\n\nAsk your agent to set up the Alation plugin. It will prompt you for:\n\n- **Base URL** — your instance URL, e.g. `https://your-alation-instance.alationcloud.com`\n- **Client ID** — from Step 2\n\nAfter that, it will open a browser window for you to log in.\n\n> **Cowork users:** The redirect page after login will not load. This is expected. Copy the full URL from that page and paste it back into the chat so Claude can finish authentication.\n\n## Usage Examples\n\nOnce you're set up, just ask in natural language. Here are some things you can try:\n\n```\nWhat marketing data do we have?\n```\n```\nSearch the catalog for anything related to \"customer orders\"\n```\n```\nWhat was our total revenue last quarter?\n```\n```\nCreate an agent that can answer questions about our finance data\n```\n```\nSend me a summary of last week's sales every Monday\n```\n```\nAdd a descriptions to the customer orders data product\n```\n\n## Skills\n\n| Skill | What it does |\n|-------|-------------|\n| **ask** | Query data products, chat with AI agents, invoke tools |\n| **explore** | Search and browse the data catalog, data products, and marketplaces |\n| **configure** | Create and manage agents, tools, LLMs, and data source connections |\n| **automate** | Build, run, and schedule recurring workflows |\n| **curate** | Manage data products, publish to marketplaces, enrich catalog metadata |\n| **setup** | Configure credentials and authenticate with your Alation instance |\n",
  "bytes": 5063,
  "sha": "9c890b276b0ec103488b60d762db7a60d23d2ed0def35144909e4b4462b63ed2",
  "repo_slug": "alation/alation-plugins",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_alation_alation_plugins_alation_ac7aba4f/readme"
}