opencode-plugins-termux

External plugin builder/packager for OpenCode on Termux.

This project packages plugins separately from core opencode-termux to improve resilience and rollback control.

Scope

• Termux first-class support (dpkg + pacman style outputs)
• GNU/Linux secondary compatibility path (builder scripts remain POSIX shell + python)
• Initial plugins:
  • omo (code-yeongyu/oh-my-opencode)
  • qwen-oauth-gd (gustavodiasdev/opencode-qwencode-auth)
  • qwen-oauth-fox (foxswat/opencode-qwen-auth)
  • websearch-cited (ghoulr/opencode-websearch-cited)
  • rules (frap129/opencode-rules)
  • envsitter-guard (boxpositron/envsitter-guard)
  • snippets (JosXa/opencode-snippets)
  • openspec (Octane0411/opencode-plugin-openspec)
  • mystatus (vbgate/opencode-mystatus)
  • handoff (joshuadavidthomas/opencode-handoff)
  • model-announcer (ramarivera/opencode-model-announcer)

Build examples

make list
make all PLUGIN=omo MODE=source
make all PLUGIN=qwen-oauth-gd MODE=source
make all PLUGIN=opencode-qwen-auth MODE=source
make all PLUGIN=websearch-cited MODE=source
make all PLUGIN=rules MODE=source
make all PLUGIN=envsitter-guard MODE=source
make all PLUGIN=snippets MODE=source
make all PLUGIN=openspec MODE=source
make all PLUGIN=mystatus MODE=source
make all PLUGIN=handoff MODE=source
make all PLUGIN=model-announcer MODE=source
make all PLUGIN=example MODE=source

Per-plugin subdirectories (build/debug)

Each plugin has its own independent packaging subproject under plugins/:

• plugins/oh-my-opencode/
• plugins/opencode-qwencode-auth/
• plugins/opencode-qwen-auth/
• plugins/opencode-websearch-cited/
• plugins/opencode-rules/
• plugins/envsitter-guard/
• plugins/opencode-snippets/
• plugins/opencode-plugin-openspec/
• plugins/opencode-mystatus/
• plugins/opencode-handoff/
• plugins/opencode-model-announcer/
• plugins/example/ (template)

Router behavior:

• top-level Makefile only delegates into each plugin subproject
• each plugin subproject owns fetch/build/stage/package steps

Termux CLI note:

• If a plugin has a validated CLI surface, the package may install a wrapper into $PREFIX/bin/ (/data/data/com.termux/files/usr/bin/).
• oh-my-opencode is a special-case package name and installs as oh-my-opencode, not opencode-plugin-omo.

Legacy note:

• tools/plugin-builder.sh remains for reference, but the router flow is now preferred.

Artifacts:

• plugins/<name>/packing/deb/*.deb
• plugins/<name>/packing/pacman/*.pkg.tar.*

Subproject temp/work dirs are ephemeral by default:

• <plugin>/ .work/
• <plugin>/packing/

Set KEEP_STAGING=1 only for debugging sessions.

Plugin policy (Termux)

Default recommendation is file-plugin mode in ~/.config/opencode/opencode.json.

Example:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "file:///data/data/com.termux/files/home/.config/opencode/local-plugins/ag-auth"
  ]
}

Reason: avoids fragile named-plugin auto-install chains when npm/bun postinstall/native deps drift.