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 10 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 | ✓ | ✓ | | 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.

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 和所有模型，无需手写任何 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 | ✓ | ✓ | | 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 以应用兼容补丁。

常见问题

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

许可证

MIT — 详见 LICENSE