Package Exports

@hung319/opencode-iflow-cli
@hung319/opencode-iflow-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@hung319/opencode-iflow-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

OpenCode iFlow CLI Plugin

OpenCode plugin for iFlow.cn providing access to Qwen, DeepSeek, Kimi, GLM, and iFlow ROME models with auto-configuration and headless OAuth support.

Features

Auto-configuration: Models are automatically configured, no manual setup needed.
Dual authentication: OAuth 2.0 (PKCE) and API Key support.
Headless support: Works in SSH, containers, and CI environments with manual code input.
Multi-account rotation: Sticky and round-robin strategies for account selection.
Automated token refresh and rate limit handling with exponential backoff.
Native thinking mode support for GLM-4.x and DeepSeek R1 models.
Flexible OAuth: Automatic browser redirect OR manual code input - both work!

Installation

npm install -g @hung319/opencode-iflow-cli

Or add to your opencode.json with specific version:

{
  "plugin": ["@hung319/opencode-iflow-cli@2.0.0"]
}

Then select "iFlow" from the provider list. You'll see both options:

API Key (built-in)
OAuth 2.0 (added by this plugin)

That's it! Models are automatically configured. No manual provider configuration needed.

Quick Start

Interactive Mode (with browser)

opencode auth login
# Select: iFlow → Enter  
# Choose: OAuth 2.0 or API Key

Browser will open automatically. Complete authentication and you're done!

Headless Mode (SSH, CI, Containers)

opencode auth login
# Select: iflow (lowercase) → Enter
# Choose: OAuth 2.0

Open the displayed URL in your local browser.
Complete authentication on iFlow.cn.
Copy the callback URL or authorization code.
Paste it back into the terminal.

The plugin automatically detects headless environments and adapts accordingly.

Configuration

Optional configuration file at ~/.config/opencode/iflow.json:

{
  "default_auth_method": "oauth",
  "account_selection_strategy": "round-robin",
  "auth_server_port_start": 8087,
  "auth_server_port_range": 10,
  "max_request_iterations": 50,
  "request_timeout_ms": 300000,
  "enable_log_api_request": false
}

Configuration Options

Option	Description	Default
`default_auth_method`	Auth method (`oauth`, `apikey`)	`oauth`
`account_selection_strategy`	Rotation strategy (`sticky`, `round-robin`)	`round-robin`
`auth_server_port_start`	OAuth callback server starting port	`8087`
`auth_server_port_range`	Number of ports to try	`10`
`max_request_iterations`	Max iterations to prevent hangs	`50`
`request_timeout_ms`	Request timeout in milliseconds	`300000`
`enable_log_api_request`	Enable request/response logging	`false`

Environment Variables

All config options can be overridden via environment variables:

export IFLOW_DEFAULT_AUTH_METHOD=oauth
export IFLOW_ACCOUNT_SELECTION_STRATEGY=round-robin
export IFLOW_AUTH_SERVER_PORT_START=8087
export IFLOW_MAX_REQUEST_ITERATIONS=50
export IFLOW_REQUEST_TIMEOUT_MS=300000

Supported Models

Models are automatically configured when you install the plugin:

Model	Context	Output	Features
`iflow-rome-30ba3b`	256K	64K	iFlow ROME 30B
`qwen3-coder-plus`	1M	64K	Qwen3 Coder Plus
`qwen3-max`	256K	32K	Qwen3 Max
`qwen3-vl-plus`	256K	32K	Vision support
`qwen3-235b-a22b-thinking-2507`	256K	64K	Thinking mode
`kimi-k2`	128K	64K	Kimi K2
`kimi-k2-0905`	256K	64K	Kimi K2 0905
`glm-4.6`	200K	128K	Thinking + Vision
`deepseek-v3`	128K	32K	DeepSeek V3
`deepseek-v3.2`	128K	64K	DeepSeek V3.2
`deepseek-r1`	128K	32K	Reasoning model
`qwen3-32b`	128K	32K	Qwen3 32B

Data Storage

Linux/macOS:

Credentials: ~/.config/opencode/iflow-accounts.json
Config: ~/.config/opencode/iflow.json

Windows:

Credentials: %APPDATA%\opencode\iflow-accounts.json
Config: %APPDATA%\opencode\iflow.json

Thinking Models

GLM-4.6

Variants with thinking budgets:

{
  "model": "glm-4.6",
  "variant": "medium"
}

Available variants:

low: 1024 thinking tokens
medium: 8192 thinking tokens
max: 32768 thinking tokens

DeepSeek R1

{
  "model": "deepseek-r1",
  "variant": "medium"
}

Same variant options as GLM-4.6.

Headless Environment Detection

The plugin automatically detects headless environments via:

SSH_CONNECTION, SSH_CLIENT, SSH_TTY
OPENCODE_HEADLESS
CI, CONTAINER
Missing DISPLAY on Linux

In headless mode:

OAuth URL is displayed for manual opening
Browser auto-open is disabled
Manual code input is prompted

License

MIT

Disclaimer

This plugin is provided strictly for learning and educational purposes. It is an independent implementation and is not affiliated with, endorsed by, or supported by iFlow.cn. Use of this plugin is at your own risk.

Feel free to open a PR to optimize this plugin further.

@hung319/opencode-iflow-cli