feat(cli): Support debug tool calling directly in CLI. #6564

Eric-Guo · 2026-01-01T08:02:05Z

Close #7802 7802

So now we can testing tools directly in cli without calling LLM.

opencode debug agent plan --tool glob --params '{pattern: "export*", include: "*.ts"}'

{
  "tool": "glob",
  "input": {
    "pattern": "export*",
    "include": "*.ts"
  },
  "result": {
    "title": "",
    "metadata": {
      "count": 1,
      "truncated": false
    },
    "output": "/Users/guochunzhong/git/oss/opencode/packages/opencode/src/cli/cmd/export.ts"
  }
}

Copilot

Pull request overview

This PR adds support for testing tools directly in the CLI without invoking the LLM. It introduces new --tool and --params options to the debug agent command, allowing developers to execute individual tools with specified parameters and view the results in JSON format.

Key Changes:

Added CLI options --tool and --params to specify which tool to execute and its parameters
Implemented parameter parsing that supports both JSON and JavaScript object literal syntax
Created a tool context generator to enable standalone tool execution in debug mode

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-01T08:04:28Z

packages/opencode/src/cli/cmd/debug/agent.ts

+async function getAvailableTools(agent: Agent.Info) {
  const providerID = agent.model?.providerID ?? (await Provider.defaultModel()).providerID
+  return ToolRegistry.tools(providerID, agent)
+}
+
+async function resolveTools(agent: Agent.Info, availableTools: Awaited<ReturnType<typeof getAvailableTools>>) {
  const toolOverrides = {
    ...agent.tools,
    ...(await ToolRegistry.enabled(agent)),
  }
-  const availableTools = await ToolRegistry.tools(providerID, agent)
  const resolved: Record<string, boolean> = {}
  for (const tool of availableTools) {
    resolved[tool.id] = Wildcard.all(tool.id, toolOverrides) !== false
  }
  return resolved
 }
+
+function parseToolParams(input?: string) {
+  if (!input) return {}
+  const trimmed = input.trim()
+  if (trimmed.length === 0) return {}
+
+  let parsed: unknown
+  try {
+    parsed = JSON.parse(trimmed)
+  } catch (jsonError) {
+    try {
+      parsed = new Function(`return (${trimmed})`)()
+    } catch (evalError) {
+      throw new Error(
+        `Failed to parse --params. Use JSON or a JS object literal. JSON error: ${jsonError}. Eval error: ${evalError}.`,
+      )
+    }
+  }
+
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("Tool params must be an object.")
+  }
+  return parsed as Record<string, unknown>
+}
+
+async function createToolContext(agent: Agent.Info) {


The new helper functions (parseToolParams, createToolContext, and getAvailableTools) lack documentation. Consider adding JSDoc comments to explain their purpose, parameters, return values, and any important behavior, especially for parseToolParams which has complex parsing logic and error handling.

Copilot · 2026-01-01T08:04:28Z

packages/opencode/src/cli/cmd/debug/agent.ts

+    parsed = JSON.parse(trimmed)
+  } catch (jsonError) {
+    try {
+      parsed = new Function(`return (${trimmed})`)()


Using new Function() to parse user input poses a security risk as it can execute arbitrary JavaScript code. An attacker could potentially execute malicious code by crafting a specially designed params string. Consider using a safer alternative like a dedicated YAML parser or restricting the input format to JSON only.

Copilot · 2026-01-01T08:04:29Z

packages/opencode/src/cli/cmd/debug/agent.ts

+    time: {
+      created: now,
+    },
+    parentID: messageID,


The parentID is set to the same value as the message's own id, which creates a self-referencing parent relationship. This appears to be a logic error. The parentID should typically reference a previous message in the conversation chain, or be set to null/undefined if this is the first message in the chain.

Suggested change

parentID: messageID,

parentID: undefined,

Copilot · 2026-01-01T08:04:29Z

packages/opencode/src/cli/cmd/debug/agent.ts

+      parsed = new Function(`return (${trimmed})`)()
+    } catch (evalError) {
+      throw new Error(
+        `Failed to parse --params. Use JSON or a JS object literal. JSON error: ${jsonError}. Eval error: ${evalError}.`,


The error message construction concatenates error objects directly into the string, which will display "[object Object]" instead of the actual error messages. Consider using String(jsonError) or accessing the .message property to get meaningful error information.

Suggested change

`Failed to parse --params. Use JSON or a JS object literal. JSON error: ${jsonError}. Eval error: ${evalError}.`,

`Failed to parse --params. Use JSON or a JS object literal. JSON error: ${

jsonError instanceof Error ? jsonError.message : String(jsonError)

}. Eval error: ${

evalError instanceof Error ? evalError.message : String(evalError)

}.`,

Copilot · 2026-01-01T08:04:29Z

packages/opencode/src/cli/cmd/debug/agent.ts

+    callID: Identifier.ascending("part"),
+    agent: agent.name,
+    abort: new AbortController().signal,
+    metadata: () => {},


The metadata function is defined as a no-op (empty function). If this function is expected to be called by tools, consider either providing a meaningful implementation or adding a comment explaining why it's intentionally a no-op in the debug context.

Suggested change

metadata: () => {},

// Debug tool context: metadata is accepted but intentionally ignored.

metadata: (_metadata: Record<string, unknown>) => {

// Intentionally a no-op in debug mode: metadata is not persisted or used.

},

github-actions · 2026-01-11T13:21:54Z

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

Open an issue describing the bug/feature (if one doesn't exist)
Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

Eric-Guo · 2026-01-11T13:53:29Z

@rekram1-node It's a following enhancement for #6529 and I used quit a lot in past week and found it's useful. Anything I need to do to made it accepted?

rekram1-node · 2026-01-12T04:42:21Z

/review

rekram1-node · 2026-01-12T04:42:41Z

I just dont think I saw this before, this is a fun one tho it's fine

packages/opencode/src/cli/cmd/debug/agent.ts

…: "export", include: "*.ts"}'`

…omalyco#6319) for tool availability and tool execution

…ves the symbol.

…e guide, keeping the same error behavior while avoiding mutable state in packages/opencode/src/cli/cmd/debug/agent.ts.

rekram1-node · 2026-01-13T04:54:35Z

/review

github-actions · 2026-01-13T04:56:02Z

lgtm

Copilot AI review requested due to automatic review settings January 1, 2026 08:02

Copilot started reviewing on behalf of Eric-Guo January 1, 2026 08:02 View session

Copilot AI reviewed Jan 1, 2026

View reviewed changes

Eric-Guo force-pushed the debug_tool branch 5 times, most recently from fecd38a to 534f4de Compare January 6, 2026 04:15

Eric-Guo force-pushed the debug_tool branch 2 times, most recently from fe56ca1 to 12fdf3d Compare January 11, 2026 13:21

github-actions bot added the needs:issue label Jan 11, 2026

github-actions bot removed the needs:issue label Jan 11, 2026

Eric-Guo force-pushed the debug_tool branch from 12fdf3d to 46da2e4 Compare January 12, 2026 04:40

github-actions bot reviewed Jan 12, 2026

View reviewed changes

packages/opencode/src/cli/cmd/debug/agent.ts Outdated Show resolved Hide resolved

Eric-Guo requested a review from rekram1-node January 12, 2026 05:57

Eric-Guo added 4 commits January 13, 2026 12:12

Add support `opencode debug agent plan --tool glob --params '{pattern…

88a20d0

…: "export", include: "*.ts"}'`

Updated the debug agent command to use the new permission ruleset (an…

462b4cb

…omalyco#6319) for tool availability and tool execution

Swapped the missing error class to the current one so typecheck resol…

442cc73

…ves the symbol.

✨Swapped the let/try parsing flow to an IIFE-based const per the styl…

388026a

…e guide, keeping the same error behavior while avoiding mutable state in packages/opencode/src/cli/cmd/debug/agent.ts.

Eric-Guo force-pushed the debug_tool branch from 2133ff0 to 388026a Compare January 13, 2026 04:25

rekram1-node merged commit f4f8f2d into anomalyco:dev Jan 13, 2026
3 checks passed

sauerdaniel pushed a commit to sauerdaniel/opencode that referenced this pull request Jan 13, 2026

feat(cli): Support debug tool calling directly in CLI. (anomalyco#6564)

c76ae4d

-    metadata: () => {},
+    // Debug tool context: metadata is accepted but intentionally ignored.
+    metadata: (_metadata: Record<string, unknown>) => {
+      // Intentionally a no-op in debug mode: metadata is not persisted or used.
+    },

feat(cli): Support debug tool calling directly in CLI. #6564

feat(cli): Support debug tool calling directly in CLI. #6564

Conversation

Eric-Guo commented Jan 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Jan 1, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 1, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 1, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 1, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 1, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Jan 11, 2026

Uh oh!

Eric-Guo commented Jan 11, 2026

Uh oh!

rekram1-node commented Jan 12, 2026

Uh oh!

rekram1-node commented Jan 12, 2026

Uh oh!

Uh oh!

rekram1-node commented Jan 13, 2026

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Eric-Guo commented Jan 1, 2026 •

edited

Loading