Skip to content

executor-cli.md

Latest commit

 

History

History
100 lines (72 loc) · 3.04 KB

executor-cli.md

File metadata and controls

100 lines (72 loc) · 3.04 KB
Raw

Executor CLI Integration

中文 | English

Use this path when OpenCode++ should drive a bounded harness-led loop while an external coding agent performs edits.

OpenCode Batch Executor

npm i -g opencode-ai opencode-plusplus
cd your-repo
opencode-plusplus oc run "fix login timeout bug" .

The official OpenCode Desktop plugin is the default transparent chat path. This command is the batch executor path, where OpenCode++ owns the bounded loop and OpenCode performs edits.

Read the full sidecar flow in OpenCode Transparent Sidecar Mode.

OpenCode Preset

opencode-plusplus oc init .
opencode-plusplus opencode doctor .
opencode-plusplus opencode run "fix login timeout bug" .
opencode-plusplus oc run "fix login timeout bug" .
opencode-plusplus oc report --last
opencode-plusplus oc repair

The preset uses the built-in command template:

opencode run --format json --dir {repo} "Follow the attached OpenCode++ task prompt." --file {prompt}

opencode-plusplus opencode doctor checks OpenCode installation, opencode run, opencode auth list, git repository status, .agent-context, and working-tree cleanliness.

opencode-plusplus oc init creates a project-level OpenCode agent profile aligned with the global opencode-plusplus primary mode:

.opencode/agents/opencode-plusplus.md

Inside OpenCode, select the opencode-plusplus mode before starting a Harness task. The repo-level agent mirrors the global mode prompt, so both entry points share the same tool-based workflow. This page is a developer compatibility reference; ordinary Desktop users should install the EXE.

OpenCode preset runs print a compact terminal summary by default:

OpenCode++ OpenCode Run

Task: fix login timeout bug
Decision: repair
Confidence: 0.72

Changed files:
- src/auth/session.ts
- test/auth/session.test.ts

Blocking gates:
- Evidence Guard: no test command after last edit

Next:
  opencode-plusplus oc repair
  opencode-plusplus oc report --last

Generic Command Adapter

opencode-plusplus orchestrate "fix login timeout bug" . \
  --executor opencode \
  --executor-command "opencode run --format json --dir {repo} \"Follow the attached OpenCode++ task prompt.\" --file {prompt}" \
  --max-loops 3 \
  --checkpoint git-worktree \
  --fail-on required

Recommended Flow

task
  -> plan / pack
  -> build prompt
  -> run external executor
  -> collect diff / trace / events
  -> hallucination / regression / policy / impact / verify
  -> decision report

Placeholders

  • {prompt}: path to the per-iteration prompt file supplied by OpenCode++.
  • {task}: original task text.
  • {repo}: repository path.
  • {runDir}: .agent-context/runs/<task-id>/.
  • {agent}: executor-specific agent/profile value.

Sandbox

--checkpoint git-worktree runs the executor in a temporary worktree and exports patches back to the run directory. OpenCode++ records rollback decisions and checkpoint evidence, but it does not destructively reset the user's working tree.