AI助手

Install the tools from the Marketplace

1. Add the marketplace:

   /plugin marketplace add opendatahub-io/ai-helpers
   

2. Install a plugin:

   /plugin install odh-ai-helpers
   

[!TIP] To browse and install multiple plugins interactively, use /plugin after adding the marketplace. This will show you all available plugins and allow you to install them selectively. For a complete list of all available tools, see categories.yaml or visit our website.

3. Use the commands:

   /hello-world:echo Hello from OpenDataHub!
   

Setup

1. Clone the helpers repository:

   git clone https://github.com/opendatahub-io/ai-helpers.git
   cd ai-helpers
   

2. Install globally:

   mkdir -p ~/.config/opencode/skills ~/.config/opencode/commands
   ln -sf $(pwd)/helpers/skills/* ~/.config/opencode/skills/
   ln -sf $(pwd)/helpers/commands/* ~/.config/opencode/commands/
   

These helpers are available when loading the odh-ai-helpers plugin from the marketplace as instructed above.

Testing a plugin locally (example with Claude Code)

1. Open claude
2. Run /plugin marketplace add ./
3. Run /plugin then install the local plugin
4. Test plugin and remove local marketplace after done testing which will remove plugin
5. You can now reinstall from the git marketplace

Ethical Guidelines

This project follows strict ethical guidelines for AI tool development, particularly regarding the use of real people's names and personas.

For detailed ethical guidelines and best practices, see ETHICS.md.

Pre-commit Hooks (Optional)

For additional validation, the repository includes .pre-commit-config.yaml with Red Hat security and AI-readiness hooks:

pre-commit install
pre-commit install --hook-type pre-push
pre-commit run --all-files  # Test all files

This automatically scans all tools and regenerates the complete documentation and website data.

Running Cursor Agent CLI in a Container

A container image is also available with the Cursor Agent CLI and all development tools pre-installed: ghcr.io/opendatahub-io/ai-helpers-cursor:latest

You can also build it yourself by running:

podman build -f images/cursor/Containerfile -t ai-helpers-cursor .

Or using make:

make build-cursor

To use the Cursor Agent CLI, you need to pass your CURSOR_API_KEY:

podman run -it --rm \
  --pull newer \
  --userns=keep-id \
  -e CURSOR_API_KEY=your-api-key \
  -v $(pwd):$(pwd):z \
  -w $(pwd) \
  ghcr.io/opendatahub-io/ai-helpers-cursor:latest

Environment Variables:

• CURSOR_API_KEY - Your Cursor API key (required for authentication)

Add this to your ~/.bashrc for easy launching of the container:

cursor-container() {
  podman run -it --rm \
    --pull newer \
    --userns=keep-id \
    -e CURSOR_API_KEY="${CURSOR_API_KEY}" \
    -v "$(pwd):$(pwd):z" \
    -w "$(pwd)" \
    ghcr.io/opendatahub-io/ai-helpers-cursor:latest "$@"
}