> ## Documentation Index
> Fetch the complete documentation index at: https://familyco.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugins

> Discover, enable, and govern plugins that contribute tools and skills.

Plugins extend FamilyCo with new tools, skills, and providers. Each plugin lives under `plugins/<name>/` and registers capabilities with the runtime when enabled.

## Views

* **Plugin inventory**
* **Plugin capability list** — tools, skills, providers contributed.
* **Plugin state** and approval mode.

## Actions

* Discover plugins
* Enable / disable a plugin
* Update plugin approval mode

## Integration behavior

* Enabling a plugin **refreshes** tool and skill inventories.
* Disabling a plugin **removes** its tools from active runtime usage.
* Plugin tool names are namespaced and become available to chat engine prompt and tool context when enabled.

## Lifecycle

1. Plugin discovery runs at startup (and on manual refresh).
2. Capabilities are registered with the relevant services (tools, skills, providers).
3. Tool policy (`tools.registry`, `tools.customFields`) is consulted on each session and execution.
4. The plugin loader notifies subscribers via `onPluginsRefreshed` when the inventory changes.

See [Tools](/modules/tools) for the tool policy and required custom field rules.