Skip to content

Tools

Built-in tools the LLM can call when working in OpenCorvus.

OpenCorvus ships a set of built-in tools the agent can call. Tools live under packages/opencorvus/src/tool/ and are registered through packages/opencorvus/src/tool/registry.ts.

Built-in tools

ToolPurpose
bashExecute shell commands through the configured shell
browser_previewInspect and interact with a browser preview
readRead a file (line-numbered, range-aware)
writeCreate or overwrite a file
editApply targeted string replacements
apply_patchApply a unified diff
globFind files by glob pattern
search_codeSearch file contents
listDirectory listing
webfetchFetch URL contents
websearchRun a web search
memoryPersistent memory store
todoread / todowriteRead and update the agent’s todo list
external_code_searchSearch external code sources
skillLoad a projected Skill
delegate_agentDispatch a bounded helper from coding or chat assistants
panelOperate the OpenCorvus control panel
plannerManage the assistant planning surface
mission_stateRead Mission coordination state
waitYield until an external wake condition
request_orchestrator_decision / send_mailbox_messageExchange visible worker coordination messages
questionAsk the user (when OPENCORVUS_ENABLE_QUESTION_TOOL=1)
scheduleSchedule follow-up actions
batchRun a batch of tools in one turn
analyticsEmit telemetry events

Task Orchestrator tools

Task Orchestrator sessions receive scheduler tools from the active expert-squad projection. These are not global ToolRegistry entries:

  • dispatch_agent dispatches one exact dynamic agent ID declared under the active capability_projection.agents map.
  • manage_task owns Task lifecycle and creates or revises Delivery Slice contracts. It does not complete/reject/retry a Goal or bind Goal workspaces.

Disabling a tool

{
"tools": {
"write": false,
"bash": false,
},
}

This prevents the LLM from receiving the tool definition. Use it for review-only or sandboxed agents.

Permissions

Most write/execute tools route through the permission system. See Permissions for allow / ask / deny rules.

Adding new tools

Additional executable tools belong to an installed expert-squad package. Its manifest projects exact package tool references only to the active scheduler or dynamic agents that declare them. Plugins may intercept tool definitions and execution, but cannot register agent tools.