<!-- Generated from release sources; edit site/content/docs, not this file. -->

# Introduction

Install HooKit, complete the Hook-writing tutorial, and find reusable policies.

HooKit allows defining Hooks to react to Pi Events. The Getting Started
section takes you from installation to one working Hook, then points you to
reusable policies.

1. **[Installation](installation.md)** installs HooKit globally
   or for one trusted Pi project and verifies that `/hooks` is available.
2. **[Write a hook](first-hook.md)** guides you through a
   dependency-free safety policy against a dummy `.env` file. Every
   step includes an expected result.
3. **[Explore the Hook library](library.md)** introduces stable
   Core Hooks and specialized HooKit Extras.

For work in an existing project, use **[Add a Hook](authoring.md)**
to preserve configuration, validate, load, enable, and test your policy. If a
Hook does not behave as expected, follow **[Troubleshooting](troubleshooting.md)**.

Use **[Reference](../reference/configuration/index.md)** to look up the complete
configuration contract and runtime behavior. Use **[Concepts](../concepts/overview.md)**
to understand HooKit's evaluation, composition, and security models.

Hook shells execute locally as trusted code. Read the
**[security model](../concepts/security.md)** before installing or authoring policies
from an untrusted Source.
