opencode-qoder-plugin

English | 中文

An opencode plugin that brings Qoder AI models into your terminal — fully bundled, zero manual provider configuration required.

---

English

Prerequisites

1. Install & login to Qoder CLI

qoder login

This opens a browser for OAuth. Credentials are stored at ~/.qoder/.auth/user.

2. Install opencode

npm install -g opencode-ai

---

Installation

Add to your ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-qoder-plugin"]
}

That's it. The plugin automatically injects the qoder provider and all 11 models — no provider block needed.

---

Usage

# Free lite model
opencode run -m qoder/lite "say hello"

# Auto model (paid)
opencode run -m qoder/auto "explain async/await"

# Interactive session
opencode -m qoder/auto

---

Available Models

Model ID	Name	Context	Output	Attachment	Reasoning
lite	Lite — free	180K	32K	✗	✗
auto	Auto (1.0x)	180K	32K	✓	✗
efficient	Efficient (0.3x)	180K	32K	✓	✗
performance	Performance (1.1x)	180K	32K	✓	✗
ultimate	Ultimate (1.6x)	180K	32K	✓	✓
q35model_preview	Qwen3.6-plus-preview (0x)	180K	32K	✓	✗
qmodel	Qwen-Coder-Qoder-1.0 (0.2x)	180K	32K	✓	✗
q35model	Qwen3.5-Plus (0.2x)	180K	32K	✓	✗
gmodel	GLM-5 (0.5x)	180K	32K	✓	✗
kmodel	Kimi-K2.5 (0.3x)	180K	32K	✓	✗
mmodel	MiniMax-M2.7 (0.2x)	180K	32K	✓	✗

---

Auth

The plugin reads ~/.qoder/.auth/user to detect login state. If not logged in, opencode will show a prompt: "Run qoder login in your terminal to authenticate".

---

Known Limitations

• Image input now uses an attachment fallback in the vendored SDK: when the prompt contains base64 image blocks, the plugin rewrites them into temporary files and calls qodercli --attachment ... --print ....
• This is a compatibility workaround for the current SDK streaming query path, which still does not reliably deliver image blocks end-to-end.
• attachment in model definitions reflects model-side capability; end-to-end image support in this plugin currently depends on the attachment fallback path.

TODO

• Replace the attachment fallback once the upstream SDK/CLI streaming path can consume image blocks directly.
• Keep npm run vendor:patch-sdk in the SDK refresh workflow after updating src/vendor/qoder-agent-sdk.mjs.

Release Flow

• Every push to main or master runs CI tests automatically.
• When the push lands on main / master, CI also bumps the patch version automatically, publishes to npm, then commits package.json + package-lock.json and pushes the release tag back to the repository.
• Configure NPM_TOKEN in GitHub Actions secrets before using this flow.

---

Troubleshooting

Problem	Solution
Auth prompt at startup	Run qoder login, then restart opencode
qodercli not found	Install Qoder CLI; ~/.qoder/bin/qodercli/ must exist
Model not found	Verify model ID matches the table above

---

License

MIT — see LICENSE

---

中文

前置条件

1. 安装并登录 Qoder CLI

qoder login

会打开浏览器进行 OAuth 认证，凭证存储在 ~/.qoder/.auth/user。

2. 安装 opencode

npm install -g opencode-ai

---

安装

在 ~/.config/opencode/opencode.json 中添加：

{
  "plugin": ["opencode-qoder-plugin"]
}

就这样。插件会自动注入完整的 qoder provider 和全部 11 个模型，无需手写任何 provider 配置。

---

使用方法

# 免费 lite 模型
opencode run -m qoder/lite "说你好"

# auto 模型（付费）
opencode run -m qoder/auto "解释 async/await"

# 交互式会话
opencode -m qoder/auto

---

可用模型

模型 ID	名称	上下文	输出	附件	推理
lite	Lite — 免费	180K	32K	✗	✗
auto	Auto (1.0x)	180K	32K	✓	✗
efficient	Efficient (0.3x)	180K	32K	✓	✗
performance	Performance (1.1x)	180K	32K	✓	✗
ultimate	Ultimate (1.6x)	180K	32K	✓	✓
q35model_preview	Qwen3.6-plus-preview (0x)	180K	32K	✓	✗
qmodel	Qwen-Coder-Qoder-1.0 (0.2x)	180K	32K	✓	✗
q35model	Qwen3.5-Plus (0.2x)	180K	32K	✓	✗
gmodel	GLM-5 (0.5x)	180K	32K	✓	✗
kmodel	Kimi-K2.5 (0.3x)	180K	32K	✓	✗
mmodel	MiniMax-M2.7 (0.2x)	180K	32K	✓	✗

---

认证说明

插件通过检查 ~/.qoder/.auth/user 判断登录状态。若未登录，opencode 会弹出提示：先在终端运行 qoder login。

---

已知限制

• 当前图片输入通过 vendored SDK 的 fallback 方案支持：遇到 base64 image block 时，会先落临时文件，再改用 qodercli --attachment ... --print ... 调用。
• 这属于对当前 SDK streaming query 链路的兼容修复；上游直传 image block 的路径仍不稳定。
• 模型定义中的 attachment 字段表示模型侧能力；本插件端到端图片支持当前依赖上述 attachment fallback。

TODO

• 等上游 SDK / CLI 的 streaming path 能直接消费 image block 后，再移除当前 fallback。
• 以后更新 src/vendor/qoder-agent-sdk.mjs 后，重新执行 npm run vendor:patch-sdk 以应用兼容补丁。

发布流程

• 每次推送到 main 或 master 都会自动执行 CI 测试。
• 当代码进入 main / master 时，CI 会自动把版本号的 patch 位（Z 位）加 1，发布到 npm，并把更新后的 package.json、package-lock.json 以及对应 tag 提交回仓库。
• 使用前需要先在 GitHub Actions Secrets 中配置 NPM_TOKEN。

---

常见问题

问题	解决方法
启动时弹出 auth 提示	运行 qoder login，重启 opencode
qodercli not found	安装 Qoder CLI，确保 ~/.qoder/bin/qodercli/ 存在
模型找不到	检查模型 ID 是否与上表一致

---

许可证

MIT — 详见 LICENSE