# capt-hook pack test


Validate and test a plugin's capt-hook pack from its working tree.


``` bash
capt-hook pack test [OPTIONS] [PLUGIN_ROOT]
```


Pass the plugin root -- the dir holding `.claude-plugin/plugin.json` and `capt-hook/{pack.toml, hooks/}` (default: the current directory). Requires all three; validates the captain-hook dependency floor, the `pack.toml` resources and tool specs, loads only this working-tree pack, and runs its inline tests under a throwaway HOME. Exits non-zero on a missing layout, a bad dependency, an unknown resource, a load error, zero hooks, an `async_=True` decision hook, or a failing test.


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Usage: capt-hook pack test [OPTIONS] [PLUGIN_ROOT]

      Validate and test a plugin's capt-hook pack from its working tree.

      Pass the plugin root -- the dir holding ``.claude-plugin/plugin.json`` and
      ``capt-hook/{pack.toml, hooks/}`` (default: the current directory). Requires
      all three; validates the captain-hook dependency floor, the ``pack.toml``
      resources and tool specs, loads only this working-tree pack, and runs its
      inline tests under a throwaway HOME. Exits non-zero on a missing layout, a
      bad dependency, an unknown resource, a load error, zero hooks, an
      ``async_=True`` decision hook, or a failing test.

    Options:
      --json  Emit one JSON record per test (CI mode)
      --help  Show this message and exit.


# Arguments


`PLUGIN_ROOT: TEXT`  
Optional.


# Options


`--json`  
Emit one JSON record per test (CI mode)