{
  "markdown": "# Snowflake AI Kit\n\nConnect your AI coding agent to Snowflake. Plugins for **Claude Code** and **OpenAI Codex** that automatically detect Snowflake prompts and route them to [Cortex Code](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code-cli) — where 55+ built-in skills handle SQL, data governance, dynamic tables, ML, and more.\n\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-Marketplace-8A2BE2)](https://claude.com/plugins/snowflake-cortex-code)\n[![OpenAI Codex](https://img.shields.io/badge/OpenAI%20Codex-Marketplace-orange)](https://github.com/Snowflake-Labs/snowflake-ai-kit#openai-codex)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue)](LICENSE)\n[![CI](https://img.shields.io/github/actions/workflow/status/Snowflake-Labs/snowflake-ai-kit/test.yml?label=CI)](https://github.com/Snowflake-Labs/snowflake-ai-kit/actions)\n[![Plugin](https://img.shields.io/badge/Plugin-v3.3.0-green)](plugins/cortex-code)\n[![Python](https://img.shields.io/badge/Python-3.12%2B-yellow)](https://python.org)\n\n## Quick Start\n\n### Claude Code\n\n```bash\nclaude plugin install snowflake-cortex-code@claude-plugins-official\n```\n\n### OpenAI Codex\n\nFrom your terminal:\n```bash\ncodex plugin marketplace add Snowflake-Labs/snowflake-ai-kit\ncodex plugin add snowflake-cortex-code@snowflake-ai-kit\n```\n\nOr inside Codex, open `/plugins` and install \"Snowflake Cortex Code\" from the Snowflake AI Kit marketplace.\n\n### That's it\n\nAsk naturally — the plugin handles routing:\n\n- \"Show me my Snowflake warehouses\"\n- \"What databases do I have access to?\"\n- \"List all tables in my current schema\"\n- \"Create a dynamic table that refreshes hourly\"\n\nNon-Snowflake prompts (\"fix the bug in auth.py\", \"write a unit test\") stay in your current agent.\n\n## How It Works\n\n```\nYou → Claude Code / Codex → [Plugin detects Snowflake intent] → Cortex Code CLI → Snowflake\n```\n\n1. A lightweight keyword filter runs on every prompt (~50ms, no network)\n2. If Snowflake intent is detected, the plugin routes to Cortex Code CLI\n3. Cortex Code executes with 55+ specialized skills (SQL, governance, ML, streaming, etc.)\n4. Results flow back to your agent session\n\nTo explicitly invoke Cortex Code (bypassing auto-detection):\n\n```\n$cortex-run show me my warehouses and their current state\n```\n\n> *See [`plugins/cortex-code/`](plugins/cortex-code/) for full documentation on security model, envelopes, and configuration.*\n\n## Cursor\n\nWorks natively — enable \"Third-party skills\" in Cursor Settings. No separate plugin needed.\n\n## Prerequisites\n\nThe plugin requires [Cortex Code CLI](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code-cli) (`cortex`) on your PATH. Install it from the [official docs](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code-cli).\n\n### Snowflake Connection\n\nCortex Code CLI needs a Snowflake connection configured at `~/.snowflake/connections.toml`:\n\n```bash\nsnow connection add\n```\n\n## Installer\n\nThe bundled installer sets up both Snowflake CLI (`snow`) and Cortex Code CLI (`cortex`):\n\n| Platform | Command |\n|---|---|\n| macOS / Linux | `bash install.sh` |\n| Windows | `.\\install.ps1` |\n| npx (any) | `npx @snowflake-labs/ai-kit` |\n\n| Flag | Description |\n|---|---|\n| `--check` / `-Check` | Check installation status without installing |\n| `--with-claude` / `-WithClaude` | Also install Claude Code CLI + plugin |\n| `--with-codex` / `-WithCodex` | Also install OpenAI Codex CLI + plugin |\n| `--help` / `-Help` | Show help |\n\n## Skills\n\nCortex Code CLI ships with 55+ built-in skills that activate automatically based on your prompt:\n\n```bash\ncortex skill list\n```\n\nExamples: `semantic-view`, `cortex-agent`, `data-quality`, `dynamic-tables`, `cost-intelligence`, `machine-learning`, `iceberg`, `data-governance`, `cortex-ai-functions`, `deploy-to-spcs`, `lineage`, `dbt-projects-on-snowflake`, `snowflake-notebooks`, `security-investigation`, `workload-performance-analysis`.\n\nSkills are organized by source:\n\n| Category | Description |\n|---|---|\n| **BUNDLED** | Ship with the CLI binary. Updated on `cortex update`. |\n| **GLOBAL** | User-installed in `~/.snowflake/cortex/skills/`. Shared across projects. |\n| **EXTERNAL** | Added via `cortex skill add <path>` or `cortex skill add owner/repo`. |\n| **PROJECT** | Discovered from the current working directory. |\n\n## Troubleshooting\n\n| Problem | Fix |\n|---|---|\n| `cortex: command not found` | Re-run `bash install.sh` or install from [Cortex Code CLI docs](https://docs.snowflake.com/en/user-guide/cortex-code/cortex-code-cli). |\n| `snow: command not found` | Ensure `~/.local/bin` is in `$PATH`. Open a new terminal. |\n| Connection errors | Run `snow connection add`. Docs: [Specify credentials](https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/specify-credentials) |\n| Plugin not routing | Verify plugin is enabled in your agent's settings. |\n| Installer hangs on Windows | Run PowerShell as Administrator. |\n\n## Contributing\n\nAll PRs run CI on **macOS** and **Windows** via GitHub Actions ([`test.yml`](.github/workflows/test.yml)). The full test suite (200 tests) must pass on both platforms.\n\n```bash\nbash tests/run-tests.sh --verbose        # macOS / Linux\n.\\tests\\run-tests.ps1 -Verbose           # Windows (PowerShell)\n```\n\n## License\n\nCopyright (c) Snowflake Inc. All rights reserved.\n\nSkills are licensed under the [Snowflake Skills License](LICENSE-SKILLS.md). All other content is [Apache 2.0](LICENSE).\n",
  "bytes": 5438,
  "sha": "464e736b154d75afe4eaa24fbe4f165fe0c7b5d32272511c906440366c5c0c51",
  "repo_slug": "snowflake-labs/snowflake-ai-kit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_snowflake_labs_snowflake_ai_kit_snowflak_58004177/readme"
}