opencode-qoder-auth

0.2.6 verified Fri May 01 auth: no javascript

An opencode plugin that bundles Qoder AI provider access for OpenCode CLI. Current version 0.2.6, released automatically on each push to main. No manual provider configuration required; 11 models including a free lite tier. Uses a vendored Qoder SDK to avoid npm registry dependencies. Supports attachment fallback for images via qodercli. Distinct from other opencode auth plugins by being fully self-contained with zero-config setup.

Common errors

error Error: Cannot find module 'opencode-qoder-auth' ↓

cause Package not installed or plugin entry missing in opencode config.

fix

Add 'opencode-qoder-auth' to 'plugin' array in opencode.json. If running locally, ensure .opencode/plugins/qoder-auth.ts exists.

error qodercli not found ↓

cause Qoder CLI is not installed or not in PATH.

fix

Install Qoder CLI and ensure ~/.qoder/bin/qodercli/ is in PATH.

error Auth prompt: Run 'qoder login' in your terminal to authenticate ↓

cause Qoder CLI session not established.

fix

Run 'qoder login' and follow browser OAuth flow.

error Model not found ↓

cause Model ID doesn't match available models or plugin not loaded.

fix

Use a valid model ID from the table (e.g., lite, auto, efficient). Ensure plugin is configured correctly.

Warnings

gotcha Package requires node >=20.0.0. Older versions will fail to import. ↓

fix Upgrade Node.js to v20 or later.

gotcha Plugin is auto-discovered only when run inside the repository or with correct plugin config. Missing plugin config leads to 'model not found' error. ↓

fix Add 'opencode-qoder-auth' to the 'plugin' array in ~/.config/opencode/opencode.json.

gotcha Image input uses attachment fallback via qodercli; not all models support end-to-end image streaming. ↓

fix Ensure qodercli is installed and ~/.qoder/bin/qodercli/ is on PATH.

gotcha User must be logged into Qoder CLI (qoder login) before using. Otherwise auth prompt appears. ↓

fix Run 'qoder login' and restart opencode.

Install

npm install opencode-qoder-auth

yarn add opencode-qoder-auth

pnpm add opencode-qoder-auth

Imports

default

wrong

const opencodeQoderAuth = require('opencode-qoder-auth')

correct

import opencodeQoderAuth from 'opencode-qoder-auth'

Package is ESM-only (node>=20). CJS require() will fail.

QoderProvider

wrong

import QoderProvider from 'opencode-qoder-auth'

correct

import { QoderProvider } from 'opencode-qoder-auth'

Named export, not default.

models

wrong

const { models } = require('opencode-qoder-auth')

correct

import { models } from 'opencode-qoder-auth'

Named export of model list.

Quickstart

Installation and basic usage of opencode-qoder-auth plugin with opencode CLI.

// Ensure Qoder CLI is installed and logged in
// Run: qoder login

// Install opencode globally
// npm install -g opencode-ai

// Add plugin to opencode config
// ~/.config/opencode/opencode.json:
{
  "plugin": ["opencode-qoder-auth"]
}

// Use opencode with qoder models
// Free lite model:
// opencode run -m qoder/lite "say hello"

// Paid auto model:
// opencode run -m qoder/auto "explain async/await"

// Interactive session:
// opencode -m qoder/auto