Surface: CliStability: Public StableMaturity: StableSource

plugin-kit-ai test

Generated from the live Cobra command tree.

Run stable fixture-driven smoke tests against the launcher entrypoint

plugin-kit-ai test

Run stable fixture-driven smoke tests against the launcher entrypoint

Synopsis

Run stable Claude or Codex runtime smoke tests from JSON fixtures.

The command loads a fixture, invokes the configured launcher entrypoint with the correct carrier (stdin JSON for Claude stable hooks, argv JSON for Codex notify), and optionally compares or updates golden stdout/stderr/exitcode files for CI-grade regression checks.

Gemini has a production-ready 9-hook Go runtime with dedicated runtime gates and stays outside this stable fixture surface. For Gemini use go test, generate --check, validate --strict, inspect, capabilities --mode runtime, make test-gemini-runtime, then gemini extensions link . and optionally make test-gemini-runtime-live.

plugin-kit-ai test [path] [flags]

Options

      --all                 run every stable event for the selected platform
      --event string        stable event to execute (for example Stop, PreToolUse, UserPromptSubmit, or Notify)
      --fixture string      fixture JSON path for single-event runs (default: fixtures/<platform>/<event>.json)
      --format string       output format: text or json (default "text")
      --golden-dir string   golden output directory (default: goldens/<platform>)
  -h, --help                help for test
      --platform string     target override ("claude" or "codex-runtime")
      --update-golden       write current stdout/stderr/exitcode outputs into the golden files

SEE ALSO

• plugin-kit-ai - plugin-kit-ai CLI - scaffold and tooling for AI plugins