> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.rhombus.community/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code Plugins

> Install Rhombus skills, sub-agents, and hooks for Claude Code to build integrations, manage devices, and monitor alerts from your terminal.

The [Rhombus Claude Code Plugin Marketplace](https://github.com/RhombusSystems/claude-code-plugins) provides ready-made skills, sub-agents, and hooks for Claude Code, organized by persona. Each plugin gives Claude Code deep knowledge of the Rhombus platform so it can help you build integrations, manage devices, and monitor alerts directly from your terminal.

## Quick Start

<Steps>
  <Step title="Add the marketplace">
    In Claude Code, run:

    ```text theme={null}
    /plugin marketplace add RhombusSystems/claude-code-plugins
    ```
  </Step>

  <Step title="Enable your plugin">
    Enable the plugin that matches your role:

    ```text theme={null}
    /plugin enable rhombus-developer
    ```

    Or for other roles:

    ```text theme={null}
    /plugin enable rhombus-user
    /plugin enable rhombus-partner
    ```

    You can enable multiple plugins if needed.
  </Step>

  <Step title="Run a command or skill">
    Trigger commands and skills with slash commands:

    ```text theme={null}
    /rhombus-find-endpoint unlock door
    /code-review src/auth.ts
    /rhombus-alerts last 24 hours
    ```
  </Step>
</Steps>

## Available Plugins

<Tabs>
  <Tab title="Developer">
    For engineers building on the Rhombus platform. Auto-configures the official `rhombus-node-mcp` and Rhombus docs MCP servers.

    ### Commands

    | Command                  | Description                                                                            |
    | ------------------------ | -------------------------------------------------------------------------------------- |
    | `/rhombus-find-endpoint` | Search the OpenAPI spec for endpoints by keyword, tag, or operationId                  |
    | `/rhombus-schema`        | Dump the request and response schema for a specific endpoint as markdown               |
    | `/rhombus-curl`          | Generate a ready-to-run cURL command with auth headers and a skeleton request body     |
    | `/rhombus-sdk`           | Generate a typed SDK client (Python, TypeScript, Java, Go) via `openapi-generator-cli` |
    | `/rhombus-mcp-status`    | Report the status of the Rhombus MCP servers and diagnose connection issues            |
    | `/rhombus-newproject`    | Scaffold a new integration project with a typed SDK, webhook receiver, and README      |

    ### Skills

    | Skill                      | Description                                                                                      |
    | -------------------------- | ------------------------------------------------------------------------------------------------ |
    | `rhombus-api`              | Full Rhombus API reference — 900+ endpoints across 65+ service categories, plus the OpenAPI spec |
    | `rhombus-sdk-codegen`      | Generate typed SDK clients (Python, TypeScript, Java, Go, C#) from the OpenAPI spec              |
    | `rhombus-webhook-receiver` | Scaffold a webhook listener in Express, FastAPI, or AWS Lambda                                   |
    | `rhombus-edge-streaming`   | Edge streaming and third-party camera integration — RTSP, ONVIF, and analytics seekpoints        |
    | `api-doc`                  | Generate API documentation from your source code                                                 |
    | `code-review`              | Structured code review for quality, security, performance, and Rhombus conventions               |

    ### Agents

    | Agent                      | Description                                                                                      |
    | -------------------------- | ------------------------------------------------------------------------------------------------ |
    | `rhombus-api-architect`    | Designs integrations, maps endpoint chains, and weighs CLI/API/MCP/SDK trade-offs                |
    | `rhombus-webhook-debugger` | Diagnoses misbehaving webhooks — not firing, duplicates, signature failures, unexpected payloads |

    ### Hooks

    | Hook                        | Trigger           | Description                                                                                              |
    | --------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------- |
    | `rhombus-api-intercept`     | PreToolUse (Bash) | Suggests the `rhombus` CLI or SDK when it detects raw `curl`/`wget`/`fetch` calls to Rhombus API domains |
    | `rhombus-openapi-freshness` | SessionStart      | Warns when the bundled OpenAPI spec is stale (older than 90 days)                                        |

    ### Example Usage

    ```text theme={null}
    # Find the endpoint you need
    /rhombus-find-endpoint unlock door

    # Generate a typed SDK client
    /rhombus-sdk typescript

    # Review code for security and performance issues
    /code-review src/auth.ts
    ```
  </Tab>

  <Tab title="User">
    For day-to-day Rhombus platform users. Installs and keeps the Rhombus CLI up to date automatically.

    ### Commands

    | Command                    | Description                                                                             |
    | -------------------------- | --------------------------------------------------------------------------------------- |
    | `/rhombus-alerts`          | Fetch and summarize recent alerts, optionally filtered by camera and time window        |
    | `/rhombus-analyze`         | Run `rhombus analyze` on an alert or a camera + time window and summarize the activity  |
    | `/rhombus-status`          | One-shot deployment health report — cameras, door states, sensor battery, recent issues |
    | `/rhombus-watch`           | Open a Rhombus camera player in your browser                                            |
    | `/rhombus-context-refresh` | Regenerate the local deployment context — index, manifest, and per-camera stills        |

    ### Skills

    | Skill                        | Description                                                                                        |
    | ---------------------------- | -------------------------------------------------------------------------------------------------- |
    | `rhombus-cli`                | Rhombus CLI reference — install, auth, profiles, global flags, and the API service groups          |
    | `rhombus-deployment-context` | Generate, query, and analyze deployment context; covers `rhombus context`, `analyze`, and `stitch` |
    | `rhombus-mind`               | Interact with Rhombus MIND, the natural-language AI assistant (`rhombus chat` and `rhombus voice`) |
    | `rhombus-support-links`      | Curated directory of Rhombus support articles for setup and administration topics                  |

    ### Agents

    | Agent                          | Description                                                                                 |
    | ------------------------------ | ------------------------------------------------------------------------------------------- |
    | `rhombus-cli`                  | CLI assistant — builds, executes, and troubleshoots `rhombus` commands                      |
    | `rhombus-alerts`               | Alert monitoring specialist — investigates security events, downloads footage               |
    | `rhombus-devices`              | Device management — inventories cameras, sensors, and doors, and audits deployments         |
    | `rhombus-footage-investigator` | Reconstructs incidents across cameras with `analyze` and `stitch`, and builds review videos |

    ### Hooks

    | Hook                   | Trigger           | Description                                                            |
    | ---------------------- | ----------------- | ---------------------------------------------------------------------- |
    | `rhombus-cli-validate` | PreToolUse (Bash) | Validates `rhombus` commands (POST-only, kebab-case flags, JSON input) |
    | `rhombus-cli-update`   | SessionStart      | Installs the CLI if missing and checks for updates once per day        |

    ### Example Usage

    ```text theme={null}
    # Summarize recent alerts
    /rhombus-alerts last 24 hours

    # Check deployment health
    /rhombus-status

    # The agents work automatically — Claude picks the right one:
    "Show me all offline cameras"            → rhombus-devices agent
    "What alerts fired in the last hour?"    → rhombus-alerts agent
    "What happened in the lobby at 11:30pm?" → rhombus-footage-investigator agent
    ```
  </Tab>

  <Tab title="Partner">
    For MSP and reseller partners managing multiple client organizations. Adds multi-org tooling on top of the CLI auto-installer.

    ### Commands

    | Command                   | Description                                                                                                     |
    | ------------------------- | --------------------------------------------------------------------------------------------------------------- |
    | `/rhombus-clients`        | List managed client organizations with active/inactive state and per-client camera counts                       |
    | `/rhombus-client-switch`  | Set the active client organization for this workspace                                                           |
    | `/rhombus-audit-clients`  | Metric-per-client audit across every managed org (offline cameras, alert volume, storage, license, door issues) |
    | `/rhombus-client-alerts`  | Recent alerts scoped to a specific client organization                                                          |
    | `/rhombus-client-devices` | Device inventory for one client organization — cameras, doors, and sensors                                      |
    | `/rhombus-fleet-report`   | Cross-client fleet report — weekly health, monthly executive, or incident rollup                                |

    ### Skills

    | Skill                            | Description                                                                                              |
    | -------------------------------- | -------------------------------------------------------------------------------------------------------- |
    | `rhombus-partner-cli`            | Partner CLI reference — authentication, the `--partner-org` flag, and multi-org workflows                |
    | `rhombus-cross-client-reporting` | Fleet-wide health and activity reports across every managed organization                                 |
    | `rhombus-partner-onboarding`     | Runbook for onboarding a new client org — API access, admin invite, retention, alert routing, smoke test |

    ### Agents

    | Agent                       | Description                                                                   |
    | --------------------------- | ----------------------------------------------------------------------------- |
    | `rhombus-client-selector`   | Resolves ambiguous client names to the canonical org name or UUID             |
    | `rhombus-fleet-ops`         | Runs operations across every managed org — audits, health checks, and rollups |
    | `rhombus-client-onboarding` | Walks through adding a new client to partner management, validating each step |

    ### Hooks

    | Hook                           | Trigger           | Description                                                     |
    | ------------------------------ | ----------------- | --------------------------------------------------------------- |
    | `rhombus-cli-validate`         | PreToolUse (Bash) | Partner-aware `rhombus` command validation                      |
    | `rhombus-partner-session-init` | SessionStart      | Loads the active-client session state for partner workflows     |
    | `rhombus-cli-update`           | SessionStart      | Installs the CLI if missing and checks for updates once per day |

    ### Example Usage

    ```text theme={null}
    # List managed client orgs
    /rhombus-clients

    # Set the active client, then work against it
    /rhombus-client-switch "Acme Corp"

    # Audit offline cameras across the whole fleet
    /rhombus-audit-clients offline-cameras
    ```
  </Tab>
</Tabs>

## Prerequisites

* [Claude Code](https://claude.ai/code) installed (CLI, desktop app, or IDE extension)
* For user/partner plugins: [Rhombus CLI](/rhombus-cli) installed and authenticated

## Manual Installation

If you prefer to embed skills directly in your project instead of using the plugin marketplace:

<Steps>
  <Step title="Clone the repository">
    ```bash theme={null}
    git clone https://github.com/RhombusSystems/claude-code-plugins
    ```
  </Step>

  <Step title="Copy the skill you need">
    ```bash theme={null}
    cp -r claude-code-plugins/plugins/developer/skills/code-review ./skills/
    ```
  </Step>

  <Step title="Use the skill">
    The skill is available in Claude Code from your project directory.
  </Step>
</Steps>

## How Plugins Work

Each plugin contains a combination of:

* **Commands** — Slash commands (e.g. `/rhombus-find-endpoint`) that run a specific, often side-effecting, task on demand.
* **Skills** — Markdown files (`SKILL.md`) with instructions Claude follows when a task matches. Skills can include supporting files like agent prompts, scripts, and templates.
* **Agents** — Specialized sub-agent prompts that Claude dispatches for specific tasks (device management, alert investigation, etc.)
* **Hooks** — Automatic actions triggered by Claude Code events (e.g., validating commands before execution, checking for CLI updates on session start)

## Resources

<CardGroup cols={2}>
  <Card title="GitHub Repository" icon="github" href="https://github.com/RhombusSystems/claude-code-plugins">
    Source code, all plugins, and contributing guide
  </Card>

  <Card title="Rhombus CLI" icon="terminal" href="/rhombus-cli">
    Required for user and partner plugins
  </Card>

  <Card title="Rhombus API MCP" icon="microchip" href="/rhombus-mcp">
    Alternative: connect Claude to Rhombus via MCP server
  </Card>

  <Card title="Documentation MCP" icon="robot" href="/documentation-mcp">
    Search Rhombus docs from any MCP-compatible AI tool
  </Card>
</CardGroup>
