Tool

command

Inspect and manage the RepoQL host from an agent using the same command vocabulary as the CLI.

Search and read tools answer questions about indexed content. command handles the running service: its status, configuration, account connection, imports, and diagnostics. It is useful when the question is about RepoQL itself or when an agent needs to change a setting.

Find out what the host is doing

Start with status when results are missing or indexing seems incomplete. It can distinguish a host that is still processing files from one that has finished with errors. Diagnostics provide more detail when status does not explain the problem.

A host can serve more than one client. Restarting it or changing its configuration can affect other sessions connected to it, so check the host and repository identity before making a change.

Use the installed help for the exact command

The command string follows the CLI’s command grammar, without the initial rql. For example, an agent passes host status to inspect the service. Help lists the commands supported by the installed version and their options.

Example: inspect the host

Terminal

rql host status

Through MCP, the same request uses the command tool with its command parameter set to host status.

Command reference

Terminal

rql command "help"

The MCP tool requires one string parameter, command. Add --help to a command to inspect its arguments. Configuration and account commands can change state; reading help or status does not.

Further reference

In the installed manual: help:///commands/**.