How are the test results reported?

The framework generates a detailed TEST-RESULTS.md file within the temporary test environment, summarizing all passed and failed validation checks in a readable format.

Does it support CI/CD integration?

Absolutely, the framework includes a CLI-based test runner that can be easily integrated into GitHub Actions or other automated CI pipelines.

Can I test security hooks with this framework?

Yes, it specifically supports testing PreToolUse and PostToolUse hooks to verify security logic, command blocking, and input modification.

What is the Plugin Test Framework for Claude Code?

It is a specialized skill that creates isolated virtual environments to test Claude Code plugins, hooks, and agents without affecting your production setup.

Does testing affect my local filesystem?

No, the framework uses isolated directories in /tmp/ to ensure that all tests and file operations remain decoupled from your actual project files.

Plugin Test Framework

Name: Plugin Test Framework
Author: chkim-su

bychkim-su

Security & Testing

Provides a virtual, isolated test environment for validating Claude Code hooks, plugins, and agent configurations without affecting production environments.

About

The Plugin Test Framework is a comprehensive utility designed for developers building on the Claude Code platform. It enables the creation of isolated virtual environments to rigorously verify the behavior of hooks, validate plugin metadata, and ensure agent definitions function as intended. By simulating various lifecycle events like PreToolUse and PostToolUse, it allows for safe testing of security guards, logging mechanisms, and context injectors, ensuring your custom AI tools are robust and secure before deployment.

Key Features

Isolated virtual test environments for safe experimentation
Automated hook validation for security guards and input modification
Agent definition and tool access configuration checks
0 GitHub stars
Integrated test runner with Markdown-based results reporting
Plugin structure and metadata schema verification (plugin.json)

Use Cases

Validating security hooks that block dangerous terminal commands
Testing complex agent prompts and tool permissions in isolation
Integrating automated plugin validation into CI/CD pipelines

About

Key Features

Isolated virtual test environments for safe experimentation
Automated hook validation for security guards and input modification
Agent definition and tool access configuration checks
0 GitHub stars
Integrated test runner with Markdown-based results reporting
Plugin structure and metadata schema verification (plugin.json)

Use Cases

Validating security hooks that block dangerous terminal commands
Testing complex agent prompts and tool permissions in isolation
Integrating automated plugin validation into CI/CD pipelines