> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ixo.world/llms.txt
> Use this file to discover all available pages before exploring further.
# Bundled plugins
> Reference for every plugin the oracle runtime ships with — toggle each one through the features map, set its env vars, and ship to production.
The runtime bundles 15 plugins that load by default; opt out per plugin via the `features` map on `createOracleApp`. One additional plugin — [`flows`](/build-an-oracle/reference/bundled-plugins/flows) — ships in the package but is **opt-in only**: wire it in explicitly via the `plugins` array.
## At a glance
| Name | Visibility | Default state | Required env | Depends on |
| ------------------------------------------------------------------------------------- | ----------- | -------------------------------- | ------------------------------------- | ----------------------- |
| [`memory`](/build-an-oracle/reference/bundled-plugins/memory) | `always` | Auto-detect | `MEMORY_MCP_URL`, `MEMORY_ENGINE_URL` | — |
| [`portal`](/build-an-oracle/reference/bundled-plugins/portal) | `on-demand` | On | — | — |
| [`firecrawl`](/build-an-oracle/reference/bundled-plugins/firecrawl) | `on-demand` | Auto-detect | `FIRECRAWL_MCP_URL` | — |
| [`domain-indexer`](/build-an-oracle/reference/bundled-plugins/domain-indexer) | `always` | On | — | — |
| [`composio`](/build-an-oracle/reference/bundled-plugins/composio) | `on-demand` | Auto-detect | `COMPOSIO_API_KEY` | — |
| [`sandbox`](/build-an-oracle/reference/bundled-plugins/sandbox) | `always` | Auto-detect | `SANDBOX_MCP_URL` | — |
| [`skills`](/build-an-oracle/reference/bundled-plugins/skills) | `always` | On | — | `sandbox` |
| [`editor`](/build-an-oracle/reference/bundled-plugins/editor) | `always` | On | — | — |
| [`agui`](/build-an-oracle/reference/bundled-plugins/agui) | `on-demand` | On | — | — |
| [`slack`](/build-an-oracle/reference/bundled-plugins/slack) | `silent` | Auto-detect | `SLACK_BOT_OAUTH_TOKEN` | — |
| [`tasks`](/build-an-oracle/reference/bundled-plugins/tasks) | `on-demand` | Auto-detect | `REDIS_URL` | — |
| [`credits`](/build-an-oracle/reference/bundled-plugins/credits) | `silent` | On unless `DISABLE_CREDITS=true` | — | — |
| [`calls`](/build-an-oracle/reference/bundled-plugins/calls) | `silent` | On (stub) | — | — |
| [`user-preferences`](/build-an-oracle/reference/bundled-plugins/user-preferences) | `always` | On | — | — |
| [`matrix-group-chats`](/build-an-oracle/reference/bundled-plugins/matrix-group-chats) | `on-demand` | On | — | — |
| [`flows`](/build-an-oracle/reference/bundled-plugins/flows) | `on-demand` | Opt-in (not bundled) | — | `editor` Qi Flow engine |
`Default state` legend:
* **On** — loaded by default; opt out with `features: { name: false }`.
* **Auto-detect** — loaded when its env var is set; opt in by setting it, force on with `features: { name: true }`, force off with `false`.
* **(stub)** — placeholder entry in `BUNDLED_PLUGINS` so feature toggles work; full implementation deferred.
## How to use `features`
```ts theme={"system"}
const app = await createOracleApp({
config,
features: {
composio: false, // never load even if COMPOSIO_API_KEY is set
slack: true, // force load even if SLACK_BOT_OAUTH_TOKEN is missing (will fail env validation)
'domain-indexer': 'auto', // explicit auto (same as omitting)
},
});
```
`true` forces on, `false` forces off, `'auto'` runs the plugin's `autoDetect` callback. Omitted keys default to `'auto'`.
## Browse
Durable memory across conversations.
Browser-side actions on the user's Portal UI.
Web search and human-readable page scraping.
IXO entity lookup — orgs, projects, DAOs, DIDs.
SaaS tool catalog (Gmail, GitHub, Linear, …).
Per-user Linux box for code execution.
IXO skill capsule discovery.
Read and edit BlockNote workspace pages.
Render interactive UI components in the browser.
Slack bot transport.
Schedule the agent to run on time-based triggers, in the background.
Per-user credit enforcement and claim settlement.
LiveKit call integration (stub — deferred).
Tone / format / language preferences.
Gate the bot + per-room compacted memory for Matrix group rooms.
Author and inspect multi-step Qi Flow templates (opt-in).
## Wiring custom-constructed plugins
Some plugins accept constructor args. Pass a custom instance via the `plugins` array — the loader dedupes by name, so your instance overrides the bundled default.
**`credits` genuinely needs a Redis client.** Without one the enforcement middleware loads in pass-through mode and the settlement cron is skipped, so production must construct it explicitly:
```ts theme={"system"}
import { createOracleApp, CreditsPlugin } from '@ixo/oracle-runtime';
import Redis from 'ioredis';
const redis = new Redis(process.env.REDIS_URL!);
const app = await createOracleApp({
config,
plugins: [new CreditsPlugin({ redis, network: 'devnet' })],
});
```
**`editor` works from env on its own.** The bundled `editorPlugin` is fully functional: when no `matrixClient` is passed it lazily builds an internal Matrix client from the `MATRIX_*` admin env vars. Pass `matrixClient` only to reuse a client your app already keeps synced:
```ts theme={"system"}
import { createOracleApp, EditorPlugin } from '@ixo/oracle-runtime';
import * as sdk from 'matrix-js-sdk';
const matrixClient = sdk.createClient({ /* ... */ });
const app = await createOracleApp({
config,
plugins: [new EditorPlugin({ matrixClient })], // optional — env fallback otherwise
});
```
## Read next
Why `skills` + `sandbox` are paired in the catalog.
`features` patterns in depth.
All env vars in one table.
Every field a plugin manifest declares.