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

# AI assistant

> Configure Catalyst's optional OpenAI-compatible assistant and understand what it can change.

Catalyst includes an optional assistant panel that can answer questions about the current page, explain server logs, and propose safe server actions.

## Providers

The assistant works with OpenAI-compatible chat completion APIs.

| Provider preset | Default model             | Base URL                         |
| --------------- | ------------------------- | -------------------------------- |
| OpenAI          | `gpt-4o-mini`             | `https://api.openai.com/v1`      |
| OpenRouter      | `openai/gpt-4o-mini`      | `https://openrouter.ai/api/v1`   |
| Groq            | `llama-3.3-70b-versatile` | `https://api.groq.com/openai/v1` |
| Custom          | `gpt-4o-mini`             | `http://localhost:1234/v1`       |

<Info>
  The custom provider can be used with local or self-hosted OpenAI-compatible endpoints. API key requirements depend on that endpoint.
</Info>

## Context sent to the assistant

When you send a message, Catalyst can include:

* Current route and page.
* Selected server name, status, RAM, player count, and platform.
* Recent console logs.
* Relevant server properties.

## Confirmed actions

The assistant can propose actions, but Catalyst asks before applying them.

<Tabs>
  <Tab title="Properties">
    Allowed keys include `max-players`, `view-distance`, `simulation-distance`, `motd`, `difficulty`, `pvp`, `white-list`, `enforce-whitelist`, and `spawn-protection`.
  </Tab>

  <Tab title="Files">
    File writes are limited to configuration-like file extensions under `plugins/`, `mods/`, or `config/`, and size limits apply.
  </Tab>

  <Tab title="Commands">
    Commands require an online server, cannot contain newlines, and are capped in length. Catalyst strips a leading slash before sending.
  </Tab>
</Tabs>

<Warning>
  Treat assistant output like a suggested admin action. Review the change before confirming it, especially on public or production servers.
</Warning>