opencode-ask-human

An OpenCode plugin that teaches agents to ask before they guess.

Features

• Rewrites the built-in question tool description
• Encourages concise questions for product intent, private APIs, environments, business rules, and acceptance criteria
• Keeps custom answers enabled
• Does not add UI, intercept messages, or force questions

Requirements

• OpenCode >=1.17.7

Install

Copy and paste:

opencode plugin --global opencode-ask-human

This installs the plugin globally so it works across projects.

For project-only install, omit --global:

opencode plugin opencode-ask-human

Usage

1. Install the plugin globally.
2. Restart OpenCode.
3. Continue working normally.

When an agent needs context that only you probably know, the question tool description now nudges it to ask one small question instead of guessing.

Config

Prefer editing config yourself? Add this to opencode.json or opencode.jsonc:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "opencode-ask-human"
  ]
}

Development

npm install
npm run typecheck
npm run build
npm pack --dry-run

The package exports an OpenCode plugin server from ./server and builds to dist/ with TypeScript.

Publishing

Publish the first version locally so the package exists on npm:

npm login
npm run typecheck
npm publish --dry-run
npm publish --access public

Then configure npm Trusted Publishing for this repo:

• Package: opencode-ask-human
• Provider: GitHub Actions
• Repository: 3xjn/opencode-ask-human
• Workflow: publish.yml

After that, publish from GitHub by creating a release, or run the Publish to npm workflow manually.

For later local publishes:

npm publish --dry-run
npm publish