@orvix-id/pi0.1.0

Pi extension for the Orvix Coding Plan

algonacci Published 25 days ago MIT ~143 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Reports 0

No reports yet.

Readme

@orvix-id/pi

Pi extension for the Orvix Coding Plan. Pi runs the agent; this extension connects it to https://api.orvix.id/coding/v1 and keeps every session on the prompt cache.

Pi is the lightest of the supported harnesses: in our measurements a Pi session sent about a third of the prompt tokens of the same task in OpenCode, so your Coding quota lasts longest here.

Using OpenCode or Oh My Pi instead? See @orvix-id/opencode and @orvix-id/omp.

Setup

Create a Coding key. In platform.orvix.id/api-keys, create a key and tick Orvix Coding (coding:invoke). The default AI Router scope (ai:invoke) is not enough; Coding endpoints answer 401 coding:invoke scope required.
Expose the key to Pi:
```
export ORVIX_CODING_API_KEY="orv-sk_live_..."
```
Put it in your shell profile or secret manager rather than typing it into commands you share.
Install the extension, then restart Pi or run /reload:
```
pi install npm:@orvix-id/pi
```
To try it once without installing: pi -e npm:@orvix-id/pi.
Pick a model: pi --model orvix-coding/deepseek-v4-flash, or /model inside Pi.

Models

The model list comes from GET /coding/v1/models when the key is available, so it always matches your plan. Without network access the extension falls back to the lineup it shipped with. Model ids drop the orvix/ prefix: orvix-coding/glm-5.2 calls orvix/glm-5.2. Pi's thinking levels map to reasoning_effort; levels a model does not support are clamped instead of sent.

What the extension does

Piece	Why
Provider `orvix-coding` on Pi's built-in `openai-completions` API	Message conversion, tools, and usage accounting stay Pi's own.
`session_id` added in `before_provider_request`	Orvix keeps a session on the same upstream route and prompt cache only when the request body carries `session_id`. Pi's session id is stable across `--continue`.
`x-orvix-coding-client` header	Reports the client name and extension version. Used for diagnostics only.

Troubleshooting

Symptom	Cause
`No models available`	The extension is not installed, or `ORVIX_CODING_API_KEY` is not set in Pi's environment.
`401 coding:invoke scope required`	The key was created without the Orvix Coding scope.
`429 coding_concurrency_exceeded`	Too many Coding requests in flight at once. Pi retries; `retry_after` is a few seconds.
`429 coding_quota_exceeded`	A 5-hour, weekly, or monthly window is used up. `resets_at` says when.

Development

bun install
bun run check
bun run probe        # 3 real Pi turns against a local mock, reports prefix reuse per request

License

MIT