Utilities and internals
Utility tools provide small pieces of runtime information or support hidden agents such as Configuru and Retitler.
Some of these tools are primarily agent-facing. They are documented here so their presence in permissions, logs, or traces is understandable.
General utilities
| Tool | Side effects | Purpose |
|---|---|---|
squad_info |
None. | Shows plugin/runtime diagnostic metadata and config diagnostics. |
current_datetime |
None. | Returns the current local date and time. |
file_inspector |
Read-only. | Inspects file metadata, binary hints, and optional MIME type. |
container_runtime |
Read-only by default. | Detects Docker/Podman, Compose support, SELinux state, and project container files. |
Use squad_info for plugin diagnostics and file_inspector when agents need metadata before deciding how to read or process files.
Configuru support tools
| Tool | Side effects | Purpose |
|---|---|---|
configuru_manual_list |
Reads bundled manuals. | Lists Configuru’s internal configuration manuals. |
configuru_manual_get |
Reads bundled manuals. | Reads one Configuru manual by key. |
configuru_models_get |
Queries OpenCode model/provider availability. | Discovers available model IDs for safe routing recommendations. |
These tools support /configuru. They let the configuration agent reason from bundled manuals and discovered model availability instead of inventing concrete model IDs.
The public manual’s Configuration section exposes the same main concepts in user-facing form.
Retitler support tool
| Tool | Side effects | Purpose |
|---|---|---|
squad_retitler |
Renames the current OpenCode session. | Applies the title chosen by the hidden /retitler agent. |
Normal users should invoke /retitler rather than calling squad_retitler directly. Configure recurring naming behavior in Retitler configuration.
Permission model
Agents receive only the tools their role needs. A read-oriented agent may receive diagnostics and search tools, while implementation or command agents may receive write-capable tools. This keeps the tool surface visible without giving every agent every capability.