# Commands

## Permissions

<table><thead><tr><th width="283.12109375">Node</th><th>Description</th><th>Default</th></tr></thead><tbody><tr><td><code>comparator.use</code></td><td>Ask comparator questions</td><td><code>true</code></td></tr><tr><td><code>comparator.manage</code></td><td>Allow players to manage their own data</td><td><code>true</code></td></tr><tr><td><code>comparator.manage.clear</code></td><td>Allow players to clear their own context</td><td><code>true</code></td></tr><tr><td><code>comparator.manage.clear.other</code></td><td>Allow players to clear others' contexts</td><td><code>op</code></td></tr><tr><td><code>comparator.manage.clear.all</code></td><td>Clear context for all conversation scopes</td><td><code>op</code></td></tr><tr><td><code>comparator.manage.web</code></td><td>Allow players to control the web panel</td><td><code>op</code></td></tr></tbody></table>

## Commands

### `/ask`

Ask Comparator a question

**Usage:**

```
/ask <prompt>
```

**Arguments:**

<table data-full-width="false"><thead><tr><th>Argument</th><th>Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td>prompt</td><td>string</td><td>true</td><td>Chat prompt</td></tr></tbody></table>

**Permission:** `comparator.use`

**Aliases:** `/c` , [`@bot`](#user-content-fn-1)[^1]

{% hint style="info" %}
You can ask a question publicly in chat by sending a message like the following:

<pre><code><a data-footnote-ref href="#user-content-fn-1">@bot</a> &#x3C;prompt>
</code></pre>

For more info, see [conversation scopes](https://fletchly.gitbook.io/comparator-docs/concepts/conversation-scopes).
{% endhint %}

**Examples:**

```
/ask what's the best y-level for diamonds?
/c how do I craft a beacon?
@bot what should we build?
```

### `/comparator clear`&#x20;

Clear the conversation context for the [Default](https://fletchly.gitbook.io/comparator-docs/concepts/conversation-scopes#default-scope) scope. If no player is provided, the command clears the context for the player executing it.

**Usage:**

```
/comparator clear [selector]
```

**Arguments:**

<table data-full-width="false"><thead><tr><th>Argument</th><th>Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td>selector</td><td>player selector</td><td>false</td><td>Player(s) to clear context for</td></tr></tbody></table>

**Permissions:** `comparator.manage.clear` , `comparator.manage.clear.other`

**Examples:**

```
/comparator clear
/comparator clear Steve
/comparator clear @a
```

### `/comparator clearConsole`&#x20;

Clear the conversation context for the [Console](https://fletchly.gitbook.io/comparator-docs/concepts/conversation-scopes#console-scope) scope.

**Usage:**

```
/comparator clearConsole
```

**Permissions:** `comparator.manage.clear.other`

### `/comparator clearChat`&#x20;

Clear the conversation context for the [Public Chat](https://fletchly.gitbook.io/comparator-docs/concepts/conversation-scopes#public-chat-scope) scope.

**Usage:**

```
/comparator clearChat
```

**Permissions:** `comparator.manage.clear.other`

### `/comparator clearAll`&#x20;

Clear the conversation context for all scopes

**Usage:**

```
/comparator clearAll
```

**Permissions:** `comparator.manage.clear.all`

### `/comparator panel`&#x20;

Start, stop, restart, and get the status of the web panel.

**Usage:**

```
/comparator panel <action>
```

**Arguments:**

<table data-full-width="false"><thead><tr><th>Argument</th><th>Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td>action</td><td><code>start</code>,<code>stop</code>,<code>restart</code>,<code>status</code></td><td>true</td><td>Action to invoke on the web panel</td></tr></tbody></table>

**Examples:**

```
/comparator panel start
/comparator panel stop
/comparator panel restart
/comparator panel status
```

**Permissions:** `comparator.manage.web`

[^1]: May be different depending on what you have it set to in comparator.conf


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fletchly.gitbook.io/comparator-docs/basics/commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
