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

# chat

> Start an interactive knowledge graph REPL

Boots an interactive terminal loop leveraging an LLM connected natively to your
World instance using the Model Context Protocol.

<Info>
  This command requires an `OPENROUTER_API_KEY` to be passed as an environment
  variable to execute the backend model generation.
</Info>

<ParamField path="--world" type="string" required>
  The unique ID or human-readable slug of the target world to attach to the AI
  agent. *Alias:* `-w`
</ParamField>

<ParamField path="--write" type="boolean">
  If set, the AI agent is granted write privileges and can arbitrarily update or
  delete facts using SPARQL directly inside your world based on conversation.
</ParamField>

<ParamField path="--user-iri" type="string">
  An IRI representing the user, attached to graph modifications for provenance.
  *Alias:* `-u`
</ParamField>

<ParamField path="--assistant-iri" type="string">
  An IRI representing the AI assistant, attached to graph modifications for
  provenance. *Alias:* `-a`
</ParamField>

### Usage

```bash theme={null}
OPENROUTER_API_KEY=sk_... worlds chat --world <world> --write
```
