Build your first mod

Start with a small read-only interface

For the first version, display information without writing files, running a shell or connecting to the network. Write down what to show, which event updates it and how to turn it off.

Create the manifests

{"name":"hello-mod","version":"0.1.0"}

Place the plugin manifest at .claude-plugin/plugin.json, and the hooks manifest at hooks/hooks.json:

{"modules":["./register.tsx"]}

Write the module

Export register(on, options). Use the structure of current official examples for event names, UI interfaces and parameters, then add your logic. Do not guess APIs.

Validate and share

Validate the manifests and module loading, trigger each event manually and confirm resources are released on exit. Document permissions, versions, installation and removal in the README. Scan once before publishing, then check the source for omissions.