Ankra

Ankra plugin for Cursor and Claude Code

The Ankra plugin for Cursor and Claude Code. It connects the agent to the hosted Ankra MCP server and adds Ankra's agent skills and slash commands for building, shipping and operating Kubernetes through Ankra.

For Claude Code, run this in a terminal:

claude plugin install ankra --marketplace ankraio/cursor-plugin

Using the plugin: see plugins/ankra/README.md.

Layout

.cursor-plugin/marketplace.json   Cursor marketplace manifest

.claude-plugin/marketplace.json Claude Code marketplace manifest plugins/ankra/ .cursor-plugin/plugin.json Cursor plugin manifest .claude-plugin/plugin.json Claude Code plugin manifest mcp.json the hosted Ankra MCP server for Cursor (browser sign-in) .mcp.json the same server for Claude Code rules/ankra.mdc when and how to work through Ankra (Cursor only) skills/ generated from ankra-cli, do not edit here commands/ generated from ankra-cli, do not edit here assets/logo.svg SOURCE the ankra-cli release the skills and commands came from scripts/ sync-from-cli.sh regenerate skills and commands sync-latest-release.sh download, verify and sync a release (used by the scheduled workflow) validate-template.mjs Cursor's plugin validator, from cursor/plugin-template

Updating the skills and commands

The skills and commands are maintained in ankraio/ankra-cli (internal/skills) and also ship through ankra skills install. Change them there, cut a CLI release, then regenerate this plugin from that release:

brew upgrade ankra            # the installed CLI must match the release

scripts/sync-from-cli.sh # defaults to the installed CLI's version node scripts/validate-template.mjs

Bump version in plugins/ankra/.cursor-plugin/plugin.json and plugins/ankra/.claude-plugin/plugin.json when the plugin content changes. The two stay equal; CI checks it. Claude Code users stay on a version until it changes, so a content change without a bump never reaches them.

This also runs on its own: the Sync from ankra-cli release workflow (.github/workflows/sync-from-cli.yml) checks ankra-cli's latest stable release every morning. When it is newer than plugins/ankra/SOURCE, scripts/sync-latest-release.sh downloads that release's binary, verifies its checksum, regenerates the skills and commands, bumps the minor version and validates, and the workflow opens (or updates) a pull request from sync/ankra-cli-release. It uses only the repository's GITHUB_TOKEN. Run it by hand from the Actions tab, optionally with a tag or as a dry_run. The same script works locally without an installed ankra:

scripts/sync-latest-release.sh            # latest stable release

scripts/sync-latest-release.sh v0.30.0 # a specific release

Testing locally

Claude Code:

claude plugin validate --strict plugins/ankra

claude plugin validate . claude --plugin-dir plugins/ankra

Cursor:

mkdir -p ~/.cursor/plugins/local

cp -R plugins/ankra ~/.cursor/plugins/local/ankra-marketplace

Reload Cursor (Developer: Reload Window) and check that the rule, skills, commands and the ankra MCP server appear. If ankra skills install already wrote a local ankra plugin, move it aside while testing so the two do not overlap.

License

Apache-2.0