Tool

command

Check on and manage the RepoQL host from an agent. command reports whether indexing is finished, reads and changes settings, lists imports, and starts or restarts the host.

If you	Use
Get results that look incomplete and want to know if indexing is finished	`command` with `host status`
Want to read or change a setting, or list what is imported	`command`
Want to add or remove a repository, folder or report	`import`
Want counts or details from the index itself	`query`

Command words, then options

You pass one string: the command words, then any options, the way you would type them in a terminal without rql. For example, host status or config read --key search.rerank_enabled. Options are always named, as --option value.

help lists every command the installed version supports. Add --help to any command to see its options.

Commands	What they do
`host status`	A snapshot of the host: whether it is ready, its indexing phase, and file counts.
`host start` · `host stop` · `host restart`	Start the host if none is running, shut it down, or restart it.
`host reindex --glob <glob>`	Send the matching files back through indexing.
`config list` · `config read` · `config set`	List settings, show one with its source and default, or change one.
`import list`	List every import with its analysis depth and local path.
`account whoami` · `account login` · `account logout`	Show, start or end your RepoQL cloud sign-in.
`diagnostics memory`	The host’s memory, storage and index footprint.
`dashboard`	Open the host’s live dashboard in your browser.

Changes reach every session

Reading help, status or a setting changes nothing. Other commands do. Several agents and terminals can share one host, so restarting or stopping it interrupts all of them, and a setting you change applies to all of them. Check host status first, and change only what the task needs.

Example: is indexing finished?

Terminal

rql host status

Output

usable, indexing · ~/Source/acme-api · 101k files · rql 1.7.13
now: sweep · 1,204 files pending · 2 operations queued
incomplete: semantic 84% · 3 files failed (failed_files)
normal: account · 39 imports · version

Whether you can trust results. The first words are the verdict, and the path after them is the workspace the answer describes. usable, indexing means files are still pending, so a missing result may only mean the file isn’t indexed yet. The now: line counts them.
Which kinds of search work. Reads and structure work for every file that is indexed. semantic 84% means search by meaning covers 84% of the files so far.
Failures. 3 files failed counts files that couldn’t be indexed, and failed_files is the view that lists them. The rest of the index is still usable.
What was checked. normal: names every check that passed. A check that could not run is named on an unchecked: line, with the reason.

When indexing has finished, the answer is two lines:

ready · ~/Source/acme-api · 101k files · rql 1.7.13
normal: index · semantic · account · 39 imports · version

rql host status --all adds the detail lines: the host’s process and binary, its account, the readiness gates and the exact file counts. Through MCP, command with host status returns the same report.

In the terminal

Each of these commands has its own rql verb: rql host status, rql config read <key>, rql import list, rql account whoami. Use those. rql help lists them all.

rql command is not the terminal version of this tool. It sends command words straight to the host’s registry, which doesn’t include the host, account or import commands, and it doesn’t pass options on.

Parameters

MCP · CLI	Meaning
`command` · the matching `rql` verb	Required. The command words and options, such as `config set --key search.rerank_enabled --value true`. An empty string or `help` lists the commands.

Further reference

In the installed manual: help:///commands/host.md, help:///commands/config.md, help:///commands/command.md and the rest of help:///commands/**.