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

# SELAT Plugins for agent runtimes

> Install SELAT Plugins in Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, or Hermes to discover vetted skills and use the SELAT CLI for approved x402 and MPP payments.

# SELAT Plugins for agent runtimes

> Install SELAT in your agent harness to discover capabilities beyond the model’s built-in tools and pay for approved services from your own Circle Agent Wallet.

**SELAT Plugins** add an agent-runtime integration path for supported coding agents. They help compatible agents discover vetted skills first, then search a federated x402 and MPP service catalog when no vetted skill fits. The plugin layer wires the published `@selat-ai/selat-cli` runner into each host; Plugins and the CLI are agent-operator surfaces, not the TypeScript developer SDK. [1] [2]

The resulting workflow is designed for tasks such as web research, data enrichment, transcription, image, video, audio, or voice generation, real-time information, and on-chain actions when those capabilities are not already available in the agent runtime. Discovery is free. A paid execution begins only after the user has reviewed the price and approved the action. [1]

## Choose your agent harness

SELAT supports the following installation paths. Select the guide for the agent environment you already use; the underlying command runner remains the same across hosts. [1]

| Agent harness                     | Install SELAT                                                                                     | Read the complete guide                                                                        |
| --------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Claude Code**                   | `/plugin marketplace add SELAT-AI/selat-plugins` then `/plugin install selat@selat-plugins`       | [Claude Code setup](https://github.com/SELAT-AI/selat-plugins/blob/main/guides/claude-code.md) |
| **Codex**                         | `codex plugin marketplace add SELAT-AI/selat-plugins` then `codex plugin add selat@selat-plugins` | [Codex setup](https://github.com/SELAT-AI/selat-plugins/blob/main/guides/codex.md)             |
| **Cursor**                        | Install from **Customize → Marketplace**, then allowlist SELAT in `.cursor/sandbox.json`          | [Cursor setup](https://github.com/SELAT-AI/selat-plugins/blob/main/guides/cursor.md)           |
| **Gemini CLI**                    | `gemini extensions install https://github.com/SELAT-AI/selat-plugins --auto-update`               | [Gemini CLI setup](https://github.com/SELAT-AI/selat-plugins/blob/main/guides/gemini-cli.md)   |
| **OpenClaw**                      | `openclaw plugins install selat --marketplace https://github.com/SELAT-AI/selat-plugins`          | [OpenClaw setup](https://github.com/SELAT-AI/selat-plugins/blob/main/guides/openclaw.md)       |
| **Hermes Agent**                  | `hermes plugins install SELAT-AI/selat-plugins/plugins/selat-hermes --enable`                     | [Hermes setup](https://github.com/SELAT-AI/selat-plugins/blob/main/guides/hermes.md)           |
| **Any terminal or other harness** | `npm install -g @selat-ai/selat-cli`                                                              | [Generic installation](https://github.com/SELAT-AI/selat-plugins/blob/main/guides/generic.md)  |

> **Surface boundary:** This guide configures supported agent runtimes. Use [SELAT CLI](/docs/selat-cli) when you operate from a terminal without a harness. Use the separate [SELAT Router SDK](/docs/selat-sdk) documentation only when you are integrating paid requests into a TypeScript application. Do not combine SDK package or signer setup with this plugin installation flow.
>
> **Prerequisite:** The plugin and CLI require Node.js 18 or later. No Python installation is required. [1] [2]

## Set up the runner

After installing a plugin, confirm that the runner and wallet configuration are ready. `selat init` checks the runner dependencies, Circle authentication, wallet configuration, and payment components. `selat doctor` provides a read-only diagnostic report when setup needs attention. [1] [2]

```bash theme={null}
selat init
selat doctor
```

SELAT uses a Circle Agent Wallet for its self-custody path. The wallet’s signing material stays outside the SELAT plugin and agent context; the setup flow authenticates the wallet owner through Circle’s login process. [1] [3]

## How SELAT discovers capabilities

SELAT uses a **two-tier discovery loop** so an agent can prefer reusable, evaluated workflows before considering a one-off endpoint. This reduces the need to hand-assemble payment calls while preserving a fallback for capabilities that are not yet packaged as skills. [1]

| Tier                     | What SELAT checks                                            | Best for                                                 | Command                        |
| ------------------------ | ------------------------------------------------------------ | -------------------------------------------------------- | ------------------------------ |
| **1. Vetted skills**     | Multi-step declarative skills from the SELAT Skills registry | Repeatable, known-good workflows with defined parameters | `selat skill list --available` |
| **2. Federated catalog** | Paid x402 and MPP endpoints from supported catalogs          | One-off capabilities without a matching skill            | `selat search "<intent>"`      |

Start with free discovery. `selat search` ranks candidates without a wallet signature or payment, while `selat skill list --available` lets you browse available reusable skills. Use a paid command only after evaluating the available option and cost. [1] [2]

```bash theme={null}
# Free: browse vetted, reusable workflows
selat skill list --available

# Free: find and rank paid endpoint candidates
selat search "transcribe an audio file"

# May spend: execute a vetted multi-step skill after approval
selat skill run <skill-name> --max-amount <usd>

# May spend: discover, select, and execute a paid endpoint after approval
selat run "transcribe an audio file"
```

For a complete description of reusable skills, their manifests, and per-step payment caps, see [Skills](/docs/skills). For a terminal-first walkthrough, see [SELAT CLI](/docs/selat-cli).

## Safety and custody boundaries

The plugin is deliberately conservative around wallets and money. It detects setup state and guides the agent, but it is not a wallet-provisioning or payment-authorizing shortcut. The following boundaries are material to a safe deployment. [1]

| Action                              | Plugin behavior                                                                                                              |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Install or update the SELAT runner  | May be handled as part of the harness integration.                                                                           |
| Check availability or configuration | `selat doctor`, `selat search`, `selat skill list`, and `selat history` are read-only.                                       |
| Create or choose a wallet           | The user completes the Circle authentication and wallet setup process; the plugin does not silently create or fund a wallet. |
| Move funds or set policies          | Treat `selat fund` and `selat setup-policy` as user-driven money actions.                                                    |
| Pay for a capability                | Surface the quote or maximum amount and obtain the user’s approval before `selat run` or `selat skill run`.                  |
| Handle secret material              | Do not paste, request, or store private keys. The recommended path signs through the user’s Circle Agent Wallet.             |

> **Practical rule:** Use free discovery first. Before any command that can spend, show the user what will be purchased and obtain an explicit go-ahead. [1]

## Choose the right SELAT surface

SELAT Plugins and the SELAT CLI serve agent and operator workflows. The SELAT Router SDK is a separate developer surface for TypeScript applications that integrate paid requests in code. Choose the surface that matches how you are working. [1] [2] [4]

| If you are…                                                           | Start with           | Why                                                                                                                            |
| --------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Equipping an interactive coding agent                                 | **SELAT Plugins**    | The host-specific integration supplies the agent context and runner wiring.                                                    |
| Operating discovery, skills, or payments from a terminal              | **SELAT CLI**        | The `selat` command provides the operator workflow for setup, discovery, skills, funding, diagnostics, and payment operations. |
| Building a TypeScript application that needs fetch-like paid requests | **SELAT Router SDK** | `RouterClient` is the separate developer integration surface for programmatic requests and signing models.                     |

> More questions? See the [FAQ](https://selat.ai/faq). For SELAT's hosted discovery MCP, see [Catalog MCP](/docs/selat-mcp).

## Next steps

Continue with [SELAT CLI](/docs/selat-cli) for the terminal workflow, browse [Skills](/docs/skills) for reusable paid workflows, or build programmatically with the [SELAT Router SDK](/docs/selat-sdk).

## References

[1]: https://github.com/SELAT-AI/selat-plugins "SELAT Plugins source repository"

[2]: https://github.com/SELAT-AI/selat-cli "SELAT CLI source repository"

[3]: https://developers.circle.com/agent-stack/agent-wallets "Circle Agent Wallet documentation"

[4]: https://www.npmjs.com/package/@selat-ai/router-client "SELAT Router SDK package"