# Plugins Guide

## What a Plugin Is

A plugin extends what Maxy can do. Each plugin adds a focused capability — contacts management, Telegram messaging, scheduling, email, research. Plugins are modular: you enable only what you need.

Maxy's own capabilities are plugins too. Marketplace plugins (Stripe, Zapier) work the same way — Maxy manages all of them through conversation.

## Plugin Groups

### Core (always active)

These are part of Maxy's foundation and cannot be disabled:

| Plugin | What it does |
|--------|-------------|
| `admin` | Platform management — system status, account settings, logs, session control |
| `memory` | Graph memory — search, write, reindex, and ingest knowledge |
| `maxy-guide` | User guide and platform documentation (this plugin) |
| `cloudflare` | Cloudflare Tunnel — remote access via your custom domain |
| `anthropic` | Claude connection — API key acquisition and configuration |

### Maxy Plugins (user-selectable)

These are enabled during onboarding and can be added or removed at any time:

| Plugin | What it does |
|--------|-------------|
| `business-assistant` | Customer enquiries, scheduling, quoting, invoicing, daily briefings |
| `sales` | Buying signal detection, closing techniques, objection handling |
| `scheduling` | Calendar and scheduling — events, appointments, recurring triggers |
| `tasks` | Task lifecycle — create, update, list, relate, complete |
| `email` | Agent email account — setup, read, send, reply, search, OTP extract, status, auto-respond config |
| `contacts` | CRM contact management — create, lookup, update, list |
| `workflows` | Persistent named workflows — reusable instruction sets |
| `projects` | Structured project execution — phased sprints, investigations, reviews, retrospectives (requires Tasks plugin) |
| `web` | Web research — search and content fetching |
| `telegram` | Telegram bot — BotFather setup, messaging, channels |
| `waitlist` | Waitlist lifecycle — extract sign-ups from conversations, review |
| `replicate` | Image generation — three models for photorealistic, design, and fast draft images |

### Claude Official (marketplace)

Third-party plugins from the Claude marketplace:

| Plugin | What it does |
|--------|-------------|
| `stripe` | Live access to payment and business data |
| `zapier` | Cross-app automation — connect thousands of apps |

### Premium Plugins

Premium plugins are one-off purchases that grant permanent ownership. They are not part of the standard install — once purchased, Maxy delivers them automatically.

| Plugin | Type | What it does | Public agent |
|--------|------|-------------|-------------|
| `teaching` | Skills | Interactive tutoring, lesson planning, and study pack generation from your knowledge base | Yes — all 3 skills serve students and parents |
| `real-agency` | Bundle (8 sub-plugins) | UK estate agency skills — sales, listings, vendor management, buyer management, lead generation, coaching, business operations, and onboarding | 4 of 8 sub-plugins (sales, buyers, coaching, onboarding) |
| `writer-craft` | Skills + Agent | Manuscript review and writing craft — story architecture, reader engagement, prose craft, editorial practice, and multi-level review | No — writing craft serves the author |

**How it works:** When you purchase a premium plugin, it's delivered to your Maxy via conversation. Tell Maxy "Enable the teaching plugin" and it handles the rest. Premium plugins are yours permanently — they survive updates and reinstalls.

Some premium plugins are **bundles** — a single purchase that delivers multiple sub-plugins, each independently activatable. For example, Real Agency delivers 8 sub-plugins covering different aspects of estate agency work. You can enable all of them or just the ones you need (e.g., "Enable real-agency-sales" for just the sales skills). Enabling or disabling individual sub-plugins does not affect the others.

**Public agent embedding:** Premium plugins marked as public-eligible have their full content (skills and reference knowledge) embedded in public agent prompts. This means a public agent for a Real Agency member can handle buyer enquiries, book viewings, deliver coaching content, and onboard new applicants — all powered by the premium plugin's domain knowledge. Plugins marked admin-only (listings, vendors, leads, business) are only available to the account owner's admin agent.

Some premium plugins include specialist helpers that Maxy can dispatch for specific tasks (e.g. the writer-craft plugin includes a manuscript reviewer). These are activated automatically when the plugin is enabled.

Some premium plugins include pre-built public agent templates — ready-made configurations for customer-facing agents. When you enable the plugin, Maxy shows you what templates are available and offers to create agents from them. You review and approve every file before the agent is created. The template is a starting point — you can edit the identity, personality, plugins, and settings to make it yours. The result is a standard public agent, indistinguishable from one you created from scratch.

Some premium plugins ship pre-built workflows that are created when the plugin is enabled. These workflows are fully yours — you can inspect, edit, run, and manage them through conversation, exactly like workflows you create yourself. The plugin provides the starting point; you own the result.

## Choosing Plugins

During first-time setup, Maxy presents a plugin selection screen where you choose which plugins to activate. Core plugins are pre-selected and locked. Recommended plugins are pre-selected but optional. You can change your mind later.

## Adding or Removing Plugins

Tell Maxy:

- "Enable the Telegram plugin"
- "Add the Stripe plugin"
- "Disable the waitlist plugin"
- "Remove Zapier"

Maxy handles the installation or removal. If the plugin requires any setup (API keys, bot tokens, configuration), Maxy will walk you through it.

## Viewing Your Plugins

Ask Maxy: "What plugins do I have?" or "List my plugins."
