pi-clinepass-provider 🚀

ClinePass provider for pi — 10 curated open-weight coding models (GLM-5.2, Kimi K2.7 Code, DeepSeek V4, Qwen3.7, and more) through Cline's $9.99/month subscription with 2-5x standard API rate limits.

ClinePass uses Cline's OpenAI-compatible Chat Completions API, so no custom streaming protocol is needed — pi's built-in openai-completions streaming handles SSE parsing, tool calls, and usage tracking.

📦 Installation

As a pi extension (recommended)

pi install npm:pi-clinepass-provider
# or from git
pi install git:github.com/jellydn/pi-clinepass-provider
# or local path
pi install /path/to/pi-clinepass-provider

As an npm package

npm install pi-clinepass-provider
# or
pnpm add pi-clinepass-provider

Note: This package requires @earendil-works/pi-ai and @earendil-works/pi-coding-agent as peer dependencies. They are automatically available when installed as a pi extension; install them manually when using as a standalone npm dependency.

Pre-requirements

• pi coding agent
• A ClinePass subscription — $9.99/month

Features

• Full streaming via Cline's OpenAI-compatible /api/v1/chat/completions endpoint
• Per-token cost tracking against ClinePass reference pricing
• WorkOS OAuth token refresh — reuses your existing Cline CLI login (cline auth); no separate API key needed
• API key auto-discovery from CLINE_API_KEY env var, ~/.cline/data/settings/providers.json, or ~/.pi/agent/auth.json
• Dynamic model discovery — fetches the live model list from the Cline API at startup, falling back to a curated static list on error
• /login integration — automatic WorkOS OAuth detection or browser-assisted manual paste

Supported Models

Model	Model ID	Context
GLM-5.2	cline-pass/glm-5.2	200K
Kimi K2.7 Code	cline-pass/kimi-k2.7-code	262K
Kimi K2.6	cline-pass/kimi-k2.6	262K
DeepSeek V4 Pro	cline-pass/deepseek-v4-pro	1M
DeepSeek V4 Flash	cline-pass/deepseek-v4-flash	1M
MiMo-V2.5	cline-pass/mimo-v2.5	262K
MiMo-V2.5-Pro	cline-pass/mimo-v2.5-pro	262K
MiniMax M3	cline-pass/minimax-m3	1M
Qwen3.7 Max	cline-pass/qwen3.7-max	262K
Qwen3.7 Plus	cline-pass/qwen3.7-plus	1M

Authentication

This extension supports two authentication methods, tried in order:

Option 1: Cline CLI Login (WorkOS OAuth — recommended)

If you already use the Cline CLI (npm i -g cline) and have authenticated with cline auth, this extension automatically reuses your login — no separate API key needed.

Run pi /login and select ClinePass. The extension detects your WorkOS OAuth credentials from ~/.cline/data/settings/providers.json and logs you in instantly. Short-lived access tokens (~1 hour) are refreshed automatically via Cline's server-side endpoint.

Option 2: Static API Key (manual)

1. Subscribe to ClinePass at app.cline.bot, go to Settings → API Keys and click Generate API key. Copy it.
2. Set the environment variable:

echo 'export CLINE_API_KEY="your_key_here"' >> ~/.zshrc
source ~/.zshrc

Alternatively, run pi /login and select ClinePass — if no Cline CLI login is detected, it opens the Cline dashboard and prompts you to paste a static API key.

The Cline CLI authenticates via WorkOS OAuth (browser login). The access token is a short-lived JWT (prefixed with workos:) that expires after ~1 hour. The refresh token is longer-lived.

This extension refreshes expired tokens by calling Cline's server-side endpoint:

POST https://api.cline.bot/api/v1/auth/refresh
{"granttype": "refresh_token", "refreshToken": "<your_refresh_token>"}

The response contains a new accessToken (with workos: prefix) and a rotated refreshToken. Both are persisted in pi's auth store for subsequent requests.

If the refresh token expires or is revoked (e.g., you re-login with cline auth), simply run pi /login again to re-import your fresh credentials.

Usage

# Non-interactive
pi --model clinepass/cline-pass/deepseek-v4-flash -p "Explain async/await in JavaScript"

# Interactive
pi --model clinepass/cline-pass/kimi-k2.7-code

# List available models
pi --list-models clinepass

# Use in another project
cd my-project
pi --model clinepass/cline-pass/glm-5.2 --trust "Refactor the auth module"

Switch models in-session with /model clinepass/cline-pass/glm-5.2.

Run tests

npm test

Pre-commit

This project uses prek to enforce code quality. To install hooks:

prek install

Notes

• Pricing: ClinePass is a flat $9.99/month subscription. Per-token costs in the model table are reference values for usage tracking only.
• Context windows: estimates from ClinePass docs — verify against Cline's /models endpoint.
• Custom API base: set CLINE_API_BASE env var to override the endpoint (default: https://api.cline.bot).

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📋 Changelog

See CHANGELOG.md for release history.

Author

👤 Huynh Duc Dung

• Website: https://productsway.com/
• Twitter: @jellydn
• Github: @jellydn

Show your support

Give a ⭐️ if this project helped you!