Ankra Cli Agent Rule

{
    "system_prompt": "# Ankra CLI Best Practices\n\nAnkra is a Kubernetes cluster management platform. Its CLI (`ankra`) lets you manage organisations, clusters, add-ons, stacks, Helm releases, credentials, and tokens from the terminal.\n\n## Authentication & Configuration\n\n- Authenticate first: `ankra login`\n- Default config lives at `~/.ankra.yaml`; override with `--config <path>`\n- Override the API base URL with `--base-url` or `ANKRA_BASE_URL`\n- Supply an API token via `--token` or `ANKRA_API_TOKEN` (prefer env var in CI)\n- Logout cleanly: `ankra logout`\n\n```yaml\n# ~/.ankra.yaml example\nbase_url: https://api.ankra.io\ntoken: ${ANKRA_API_TOKEN}\n```\n\n## Organisation Management\n\n```bash\nankra org list                          # List accessible organisations\nankra org switch <org-name>             # Switch active organisation\nankra org create <name>                 # Create a new organisation\nankra org invite <email>                # Invite a user to the current org\nankra org members                       # List members of the current org\n```\n\n## Cluster Lifecycle\n\n```bash\nankra cluster list                      # List all clusters in the org\nankra cluster select <name>             # Set the active cluster context\nankra cluster info                      # Show details about the active cluster\nankra cluster provision                 # Provision a new cluster\nankra cluster deprovision               # Deprovision (destroy) the active cluster\nankra cluster reconcile                 # Reconcile cluster to desired state\nankra delete cluster <name>             # Delete a named cluster\n```\n\n- Always run `ankra cluster info` before destructive operations\n- Use `ankra cluster reconcile` after config changes before assuming state is correct\n\n## Add-ons\n\n```bash\nankra cluster addons list               # List installed add-ons\nankra cluster addons available          # List available (installable) add-ons\nankra cluster addons settings <addon>   # Show current settings for an add-on\nankra cluster addons update <addon>     # Update add-on configuration\nankra cluster addons uninstall <addon>  # Uninstall an add-on\n```\n\n## Stacks (Application Stacks)\n\n```bash\nankra cluster stacks list               # List stacks in the cluster\nankra cluster stacks create <name>      # Create a new stack\nankra cluster stacks delete <name>      # Delete a stack\nankra cluster stacks rename <old> <new> # Rename a stack\nankra cluster stacks clone <src> <dst>  # Clone a stack\nankra cluster stacks history <name>     # View stack change history\n```\n\n- Prefer `clone` over `create` when replicating an existing working stack\n- Check `history` before rolling back to understand what changed\n\n## Manifests & Operations\n\n```bash\nankra cluster manifests list            # List deployed manifests\nankra cluster operations list           # List in-progress or recent operations\nankra cluster operations cancel <id>    # Cancel a running operation\n```\n\n## Cluster Agent\n\n```bash\nankra cluster agent status              # Check agent health\nankra cluster agent token               # Retrieve agent bootstrap token\nankra cluster agent upgrade             # Upgrade the in-cluster agent\n```\n\n- Run `agent status` if cluster commands seem unresponsive\n- Rotate the agent token periodically for security\n\n## Helm\n\n```bash\nankra cluster helm releases             # List Helm releases in the cluster\nankra cluster helm uninstall <release>  # Uninstall a Helm release\nankra helm registries                   # List configured Helm registries\nankra helm credentials                  # List Helm registry credentials\n```\n\n## Hetzner Cloud Clusters\n\n```bash\nankra cluster hetzner create            # Create a Hetzner-backed cluster\nankra cluster hetzner scale             # Scale the cluster node count\nankra cluster hetzner upgrade           # Upgrade Kubernetes version\nankra cluster hetzner workers           # Manage worker node groups\nankra cluster hetzner node-group        # Node group management\n```\n\n## Charts\n\n```bash\nankra charts list                       # List available charts\nankra charts search <term>              # Search charts\nankra charts info <chart>               # Detailed chart information\n```\n\n## Credentials\n\n```bash\nankra credentials list                              # List stored credentials\nankra credentials get <name>                        # Retrieve a credential\nankra credentials validate <name>                   # Validate a credential\nankra credentials delete <name>                     # Delete a credential\nankra credentials hetzner --name <n> --token <t>   # Store Hetzner API token\nankra credentials ovh ...                           # Store OVH credentials\nankra credentials upcloud ...                       # Store UpCloud credentials\n```\n\n- Never commit credentials to source control; use `ANKRA_API_TOKEN` env var\n- Validate credentials immediately after creation: `ankra credentials validate <name>`\n\n## Tokens (API Tokens)\n\n```bash\nankra tokens list                       # List API tokens\nankra tokens create --name <name>       # Create a new API token\nankra tokens revoke <id>                # Revoke a token (keeps record)\nankra tokens delete <id>                # Permanently delete a token\n```\n\n## AI Troubleshooting\n\n```bash\nankra chat                              # Start AI-powered troubleshooting session\n```\n\nUse `ankra chat` when facing ambiguous errors — it provides contextual guidance.\n\n## Global Flags\n\n| Flag | Env Var | Description |\n|------|---------|-------------|\n| `--base-url <url>` | `ANKRA_BASE_URL` | Override API base URL |\n| `--token <token>` | `ANKRA_API_TOKEN` | API authentication token |\n| `--config <path>` | — | Path to config file (default `~/.ankra.yaml`) |\n\n## Scripting & Automation Tips\n\n- Export `ANKRA_API_TOKEN` in CI pipelines; never hard-code tokens\n- Use `--token` for one-off scripts where env var injection is not possible\n- Chain `ankra cluster select` before cluster-scoped commands in scripts\n- Pipe output through `jq` for structured processing where JSON output is available\n- Use `ankra cluster operations list` in CI to poll for async operation completion\n- Add `set -euo pipefail` to shell scripts using the Ankra CLI\n\n## Common Workflows\n\n### Provision and configure a new Hetzner cluster\n\n```bash\nankra login\nankra org switch my-org\nankra cluster hetzner create\nankra cluster select my-new-cluster\nankra cluster agent status\nankra cluster addons available\nankra cluster addons update some-addon\nankra cluster reconcile\n```\n\n### Deploy a stack from a chart\n\n```bash\nankra cluster select my-cluster\nankra charts search my-app\nankra charts info my-app\nankra cluster stacks create my-stack\nankra cluster manifests list\n```\n\n### Rotate credentials safely\n\n```bash\nankra tokens create --name ci-token-new\n# Update CI secret with new token\nankra tokens revoke <old-token-id>\nankra credentials validate my-cloud-cred\n```",
    "prompt_type": "agent_rule",
    "framework": "cursor",
    "globs": "**/*.sh, **/*.yaml, **/*.yml, Makefile, **/Makefile, **/*.md",
    "compatible_models": [
        "Claude 3.5 Sonnet",
        "GPT-4o",
        "Cursor AI",
        "Gemini 2.5 Flash"
    ],
    "download_filename": "ankra-cli.cursorrules",
    "tags": [
        "cursor",
        "cursorrules",
        "agent",
        "coding",
        "ankra"
    ]
}