Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 1 addition & 61 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -37,18 +37,6 @@
"description": "Team structure knowledge and health analysis commands for OpenShift teams",
"version": "0.0.14"
},
{
"name": "doc",
"source": "./plugins/doc",
"description": "A plugin for engineering documentation and notes",
"version": "0.0.2"
},
{
"name": "session",
"source": "./plugins/session",
"description": "A plugin for Claude session management and persistence",
"version": "0.0.2"
},
{
"name": "snowflake",
"source": "./plugins/snowflake",
Expand All @@ -65,7 +53,7 @@
"name": "utils",
"source": "./plugins/utils",
"description": "A generic utilities plugin serving as a catch-all for various helper commands",
"version": "0.0.9"
"version": "0.0.10"
},
{
"name": "olm",
Expand Down Expand Up @@ -109,30 +97,12 @@
"description": "Etcd cluster health monitoring and performance analysis utilities",
"version": "0.0.2"
},
{
"name": "yaml",
"source": "./plugins/yaml",
"description": "YAML documentation and utilities",
"version": "0.0.2"
},
{
"name": "must-gather",
"source": "./plugins/must-gather",
"description": "A plugin to analyze and report on must-gather data",
"version": "0.0.2"
},
{
"name": "lvms",
"source": "./plugins/lvms",
"description": "LVMS (Logical Volume Manager Storage) plugin for troubleshooting and debugging storage issues",
"version": "0.1.1"
},
{
"name": "native-notifications",
"source": "./plugins/native-notifications",
"description": "Cross-platform desktop notifications for ai-helpers",
"version": "0.0.2"
},
{
"name": "hcp",
"source": "./plugins/hcp",
Expand All @@ -145,36 +115,12 @@
"description": "Security compliance and vulnerability analysis tools for Go projects",
"version": "0.0.3"
},
{
"name": "test-coverage",
"source": "./plugins/test-coverage",
"description": "Analyze test coverage and identify gaps in test scenarios",
"version": "0.0.2"
},
{
"name": "node-tuning",
"source": "./plugins/node-tuning",
"description": "Generate and analyze OpenShift node tuning profiles",
"version": "1.0.0"
},
{
"name": "testing",
"source": "./plugins/testing",
"description": "Comprehensive testing utilities for operators and applications",
"version": "0.1.0"
},
{
"name": "origin",
"source": "./plugins/origin",
"description": "Helpers for openshift/origin development.",
"version": "0.0.2"
},
{
"name": "container-image",
"source": "./plugins/container-image",
"description": "Container image inspection and analysis using skopeo and podman",
"version": "0.0.2"
},
{
"name": "node",
"source": "./plugins/node",
Expand All @@ -193,12 +139,6 @@
"description": "Manage isolated git worktree workspaces for multi-repo development",
"version": "1.0.1"
},
{
"name": "gwapi",
"source": "./plugins/gwapi",
"description": "Gateway API installation utilities for Kubernetes/OpenShift clusters",
"version": "0.0.1"
},
{
"name": "code-review",
"source": "./plugins/code-review",
Expand Down
4 changes: 0 additions & 4 deletions .pruneprotect
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,5 @@
# Canonical example plugin
plugins/hello-world/

# Infrastructure plugins (hook-only, by design)
plugins/metrics/
plugins/native-notifications/

# Marketplace operations plugin
plugins/marketplace-ops/
9 changes: 0 additions & 9 deletions GEMINI.md

This file was deleted.

96 changes: 0 additions & 96 deletions PLUGINS.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,11 @@ This document lists all available Claude Code plugins and their commands in the
- [Ci](#ci-plugin)
- [Code Review](#code-review-plugin)
- [Compliance](#compliance-plugin)
- [Container Image](#container-image-plugin)
- [Doc](#doc-plugin)
- [Etcd](#etcd-plugin)
- [Git](#git-plugin)
- [Gwapi](#gwapi-plugin)
- [Hcp](#hcp-plugin)
- [Hello World](#hello-world-plugin)
- [Jira](#jira-plugin)
- [Lvms](#lvms-plugin)
- [Marketplace Ops](#marketplace-ops-plugin)
- [Must Gather](#must-gather-plugin)
- [Node](#node-plugin)
Expand All @@ -25,18 +21,13 @@ This document lists all available Claude Code plugins and their commands in the
- [Olm Team](#olm-team-plugin)
- [Openshift](#openshift-plugin)
- [Openshift Tls Profile](#openshift-tls-profile-plugin)
- [Origin](#origin-plugin)
- [Ote Migration](#ote-migration-plugin)
- [Rds Analyzer](#rds-analyzer-plugin)
- [Session](#session-plugin)
- [Snowflake](#snowflake-plugin)
- [Sosreport](#sosreport-plugin)
- [Teams](#teams-plugin)
- [Test Coverage](#test-coverage-plugin)
- [Testing](#testing-plugin)
- [Utils](#utils-plugin)
- [Workspaces](#workspaces-plugin)
- [Yaml](#yaml-plugin)

### Agendas Plugin

Expand Down Expand Up @@ -115,26 +106,6 @@ Security compliance and vulnerability analysis tools for Go projects

See [plugins/compliance/README.md](plugins/compliance/README.md) for detailed documentation.

### Container Image Plugin

Container image inspection and analysis using skopeo and podman

**Commands:**
- **`/container-image:compare` `<image1> <image2>`** - Compare two container images to identify differences
- **`/container-image:inspect` `<image>`** - Inspect and provide detailed breakdown of a container image
- **`/container-image:tags` `<repository>`** - List and analyze available tags for a container image repository

See [plugins/container-image/README.md](plugins/container-image/README.md) for detailed documentation.

### Doc Plugin

A plugin for engineering documentation and notes

**Commands:**
- **`/doc:note` `[task description]`** - Generate professional engineering notes and append them to a log file

See [plugins/doc/README.md](plugins/doc/README.md) for detailed documentation.

### Etcd Plugin

Etcd cluster health monitoring and performance analysis utilities
Expand Down Expand Up @@ -163,17 +134,6 @@ Git workflow automation and utilities

See [plugins/git/README.md](plugins/git/README.md) for detailed documentation.

### Gwapi Plugin

Gateway API management for Kubernetes/OpenShift clusters

**Commands:**
- **`/gwapi:check` `[namespace]`** - Check Gateway API resources status in the cluster
- **`/gwapi:delete` `[namespace]`** - Delete Gateway API resources from a Kubernetes/OpenShift cluster
- **`/gwapi:install` `[namespace]`** - Install Gateway API resources to a Kubernetes/OpenShift cluster

See [plugins/gwapi/README.md](plugins/gwapi/README.md) for detailed documentation.

### Hcp Plugin

Generate HyperShift cluster creation commands via hcp CLI from natural language descriptions
Expand Down Expand Up @@ -219,15 +179,6 @@ A plugin to automate tasks with Jira

See [plugins/jira/README.md](plugins/jira/README.md) for detailed documentation.

### Lvms Plugin

LVMS (Logical Volume Manager Storage) plugin for troubleshooting and debugging storage issues

**Commands:**
- **`/lvms:analyze` `[must-gather-path|--live] [--component storage|operator|volumes]`** - Comprehensive LVMS troubleshooting - analyzes LVMCluster, volume groups, PVCs, and storage issues on live clusters or must-gather

See [plugins/lvms/README.md](plugins/lvms/README.md) for detailed documentation.

### Marketplace Ops Plugin

Maintenance commands for Claude Code plugin marketplaces
Expand Down Expand Up @@ -332,15 +283,6 @@ Implementation requirements and details for OpenShift TLS security profiles

See [plugins/openshift-tls-profile/README.md](plugins/openshift-tls-profile/README.md) for detailed documentation.

### Origin Plugin

Helpers for openshift/origin development.

**Commands:**
- **`/origin:two-node-origin-pr-helper` `[--url PR_URL] [<pr>] [--depth quick|full]`** - Expert review tool for PRs that add or modify Two Node (Fencing or Arbiter) tests under test/extended/two_node/ in openshift/origin.

See [plugins/origin/README.md](plugins/origin/README.md) for detailed documentation.

### Ote Migration Plugin

Automate OpenShift Tests Extension (OTE) migration for component repositories
Expand All @@ -359,15 +301,6 @@ Reference Design Specification (RDS) Analyzer workflow: cluster-compare JSON to

See [plugins/rds-analyzer/README.md](plugins/rds-analyzer/README.md) for detailed documentation.

### Session Plugin

A plugin to save and resume conversation sessions across long time intervals

**Commands:**
- **`/session:save-session` `[optional-description]`** - Save current conversation session to markdown file for future continuation

See [plugins/session/README.md](plugins/session/README.md) for detailed documentation.

### Snowflake Plugin

Snowflake data analysis commands for engineering metrics and reports
Expand Down Expand Up @@ -405,25 +338,6 @@ Team structure knowledge and health analysis commands for OpenShift teams

See [plugins/teams/README.md](plugins/teams/README.md) for detailed documentation.

### Test Coverage Plugin

Analyze code coverage and identify untested paths

**Commands:**
- **`/test-coverage:analyze` `<path-or-url> [--output <path>] [--priority <level>] [--test-structure-only]`** - Analyze test code structure without running tests to identify coverage gaps
- **`/test-coverage:gaps` `<test-file-or-url> [--output <path>]`** - Identify E2E test scenario gaps in OpenShift/Kubernetes tests (component-agnostic)

See [plugins/test-coverage/README.md](plugins/test-coverage/README.md) for detailed documentation.

### Testing Plugin

Comprehensive testing utilities for operators and applications

**Commands:**
- **`/testing:mutation-test` `[operator-path] [--controllers <controller1,controller2>] [--mutation-types <types>] [--report-format <format>]`** - Test operator controller quality through mutation testing - validates test suite catches code mutations

See [plugins/testing/README.md](plugins/testing/README.md) for detailed documentation.

### Utils Plugin

A generic utilities plugin serving as a catch-all for various helper commands and agents
Expand All @@ -434,7 +348,6 @@ A generic utilities plugin serving as a catch-all for various helper commands an
- **`/utils:find-konflux-images` `<PR-URL>`** - Find and verify Konflux-built container images from a GitHub PR
- **`/utils:generate-test-plan` `[GitHub PR URLs]`** - Generate test steps for one or more related PRs
- **`/utils:gh-attention` `[--repo <org/repo>]`** - List PRs and issues requiring your attention
- **`/utils:placeholder`** - Placeholder command for the utils plugin
- **`/utils:process-renovate-pr` `<PR_NUMBER|open> [JIRA_PROJECT] [COMPONENT]`** - Process Renovate dependency PR(s) to meet repository contribution standards
- **`/utils:review-ai-helpers-overlap` `[--idea TEXT] [--pr NUMBER] [--verbose]`** - Review potential overlaps with existing ai-helpers (Claude Code Plugins, Commands, Skills, Sub-agents, or Hooks) and open PRs
- **`/utils:review-security` `[file-paths-or-patterns]`** - Orchestrate security scanners and provide contextual triage of findings
Expand All @@ -450,12 +363,3 @@ Manage isolated git worktree workspaces for multi-repo development
- **`/workspaces:delete` `<workspace-name>`** - Delete a workspace and its git worktrees

See [plugins/workspaces/README.md](plugins/workspaces/README.md) for detailed documentation.

### Yaml Plugin

Generate comprehensive YAML documentation from Go struct definitions with sensible default values

**Commands:**
- **`/yaml:docs` `[file:StructName] [output.md]`** - Generate comprehensive YAML documentation from Go struct definitions with sensible default values

See [plugins/yaml/README.md](plugins/yaml/README.md) for detailed documentation.
27 changes: 18 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,20 +56,29 @@ Add a SessionStart hook to automatically sync the marketplace catalog on each se

**Note:** This only refreshes the catalog (what's available). To actually update an installed plugin to a newer version, you still need to reinstall it with `/plugin install <plugin>@ai-helpers`.

### Using Cursor
### Other Tools

Cursor is able to find the various commands defined in this repo by
making it available inside your `~/.cursor/commands` directory.
Coding agents like OpenCode, Gemini, Cursor and more can consume Claude Code
plugins using the [Agent Package Manager (APM)](https://github.com/microsoft/apm).

Example `apm.yml`:

```yaml
name: my-project
version: 1.0.0
description: My project is great.
target: [claude, cursor, gemini, opencode]

dependencies:
- openshift-eng/ai-helpers/plugins/bigquery
```
$ mkdir -p ~/.cursor/commands
$ git clone git@github.com:openshift-eng/ai-helpers.git
$ ln -s ai-helpers ~/.cursor/commands/ai-helpers
```

## Using the Docker Container
Then run `apm install`. It can install to your project only, or with a `--global` scope.
Comment thread
stbenjam marked this conversation as resolved.

## Using the Container

A container is available with Claude Code and all plugins pre-installed.
A container is available with Claude Code and the marketplace already
available. This is primarily for use in OpenShift CI.

### Building the Container

Expand Down
Loading
Loading