utils

AI Helpers

A collection of Claude Code plugins to automate and assist with various development tasks.

Discover available plugins

Installation

From the Claude Code Plugin Marketplace

1. Add the marketplace:

   /plugin marketplace add openshift-eng/ai-helpers
   

2. Install a plugin:

   /plugin install jira@ai-helpers
   

3. Use the commands:

   /jira:solve OCPBUGS-12345 origin
   

Updating Plugins

To get the latest plugin versions:

1. Update the marketplace (fetches latest plugin catalog):

   /plugin marketplace update ai-helpers
   

2. Reinstall the plugin (downloads new version):

   /plugin install <plugin>@ai-helpers
   

Automatic Catalog Sync

Add a SessionStart hook to automatically sync the marketplace catalog on each session. In your project's .claude/settings.json:

{
  "hooks": {
    "SessionStart": [
      {
        "command": "claude plugin marketplace update ai-helpers",
        "timeout": 30000
      }
    ]
  }
}

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.

Other Tools

Coding agents like OpenCode, Gemini, Cursor and more can consume Claude Code plugins using the Agent Package Manager (APM).

Example apm.yml:

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

dependencies:
  - openshift-eng/ai-helpers/plugins/bigquery

Then run apm install. It can install to your project only, or with a --global scope.

Using the Container

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

The image includes two Claude Code binaries:

• claude (default entrypoint) — installed from the stable RPM channel
• claude-latest — installed from the latest RPM channel, for trying newer features or comparing behavior between versions

Building the Container

podman build -f images/Dockerfile -t ai-helpers .

Running with Vertex AI and gcloud Authentication

To use Claude Code with Google Cloud's Vertex AI, you need to pass through your gcloud credentials and set the required environment variables:

podman run -it \
  -e CLAUDE_CODE_USE_VERTEX=1 \
  -e CLOUD_ML_REGION=your-ml-region \
  -e ANTHROPIC_VERTEX_PROJECT_ID=your-project-id \
  -v ~/.config/gcloud:/home/claude/.config/gcloud:ro \
  -v $(pwd):/workspace \
  -w /workspace \
  ai-helpers

Environment Variables:

• CLAUDE_CODE_USE_VERTEX=1 - Enable Vertex AI integration
• CLOUD_ML_REGION - Your GCP region (e.g., us-east5)
• ANTHROPIC_VERTEX_PROJECT_ID - Your GCP project ID

Volume Mounts:

• -v ~/.config/gcloud:/home/claude/.config/gcloud:ro - Passes through your gcloud authentication (read-only)
• -v $(pwd):/workspace - Mounts your current directory into the container

Running Commands Non-Interactively

You can execute Claude Code commands directly without entering an interactive session using the -p or --print flag:

podman run -it \
  -e CLAUDE_CODE_USE_VERTEX=1 \
  -e CLOUD_ML_REGION=your-ml-region \
  -e ANTHROPIC_VERTEX_PROJECT_ID=your-project-id \
  -v ~/.config/gcloud:/home/claude/.config/gcloud:ro \
  -v $(pwd):/workspace \
  -w /workspace \
  ai-helpers \
  --print "/hello-world:echo Hello from Claude Code!"

This will:

1. Start the container with your gcloud credentials
2. Execute the /hello-world:echo command with the provided message
3. Print the response and exit when complete

Available Plugins

For a complete list of all available plugins and commands, see the AI Helpers Marketplace.

Plugin Development

Want to contribute or create your own plugins? Check out the plugins/ directory for examples. Make sure your commands and agents follow the conventions for the Sections structure presented in the hello-world reference implementation plugin (see hello-world:echo for an example).

Ethical Guidelines

Plugins, commands, skills, and hooks must NEVER reference real people by name, even as stylistic examples (e.g., "in the style of ").