ByteRover's CLI tool for autonomous agents, coding assistance, and knowledge management with MCP support
ByteRover CLI provides 9 tools with inconsistent quality. Most tools have basic descriptions (10-100 chars, well below the 194-char baseline) and structured schemas, but lack depth in parameter descriptions and error handling guidance. Tool naming is adequate (verb-prefixed actions), but descriptions are often generic. Schemas are present for all tools but parameter-level descriptions vary widely, some parameters like 'pattern' in glob/grep lack actionable format guidance. Output schemas are not explicitly documented. Security considerations around the 'curate' and 'agentQuery' tools (both WRITE risk) lack permission gates or dry-run patterns. The 'agentQuery' tool is particularly concerning: it spawns sub-agents with code_exec access but provides no audit trail, confirmation mechanism, or scope limiting beyond optional maxIterations.
Spawn a sub-agent to process a prompt with full code_exec access in an isolated context
Execute curate operations on knowledge topics (ADD, UPDATE, MERGE, DELETE)
Detect and validate domains from input data, categorizing text into knowledge domains
Find files matching a glob pattern
Search file contents for a regex pattern
List files and directories in a tree structure
Read file contents with optional line range limiting
Search knowledge base with BM25 ranking and optional structural filtering
curate tool lacks operation documentation. Description does not explain what ADD, UPDATE, MERGE, DELETE do, when each should be used, or what the 'operations' array structure requires. No guidance on error recovery if an operation fails partially.
agentQuery (WRITE, spawns sub-agents) lacks permission gating, audit logging, and dry-run/confirmation support. No description of what happens if a sub-agent fails, times out, or performs destructive actions. Agents can spawn unbounded child processes without scope validation.
detectDomains input schema uses a bare 'domains' array with no type specification or element documentation. What is the structure of each domain object? What fields are required? Description provides no guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 56 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 39 | 1.15.1+ | v1 |
Write content to a file with optional directory creation
glob, grep, listDirectory descriptions lack result-limit documentation. All have 'maxResults' parameters but descriptions do not state the consequence of omitting it or the practical limits. glob defaults to 1000, grep to 100, LLM reasoning about which to use is unclear.
readFile/writeFile descriptions do not state: what happens if the file does not exist (readFile), whether writeFile overwrites or appends, whether parent directory creation fails with an error. No guidance on file size limits or encoding.
searchKnowledge 'combineWith' parameter defaults to 'auto' but does not explain what 'auto' means. elementHint type is 'object' with no schema, what fields does it expect? LLM cannot determine valid input.
No tool-level documentation of output schema. LLMs do not know what fields to expect from each tool's response, making downstream tool chaining and data extraction error-prone.
No error handling guidance across any tool. Error responses should include recovery hints (e.g., 'File not found. Check the path with listDirectory()' for readFile). Current state forces LLMs to guess recovery strategy.