メインコンテンツへスキップ
oh-my-pi (コマンド omp、pi-mono とも 呼ばれる — 同じプロジェクト) は最小限で拡張可能なターミナルコーディング エージェントです。
プロトコル: OpenAI 互換
  • Base URL: https://api.orcarouter.ai/v1 (/v1 サフィックスを 含みます)

インストール

bun install -g @oh-my-pi/pi-coding-agent
bun >= 1.3.14 が必要です。インストールされるコマンドは omp です。

設定

まず API キーを環境変数としてエクスポートします:
export ORCA_KEY="sk-orca-..."
設定ファイル: ~/.omp/agent/models.yml
providers:
  orcarouter:
    baseUrl: https://api.orcarouter.ai/v1
    api: openai-completions
    apiKey: ORCA_KEY
    authHeader: true
    models:
      - id: orcarouter/auto
        name: OrcaRouter Auto
        reasoning: false
        input: [text]
        contextWindow: 200000
        maxTokens: 8192
        compat:
          supportsDeveloperRole: false
          maxTokensField: max_tokens
お好みで orcarouter/auto を特定のモデルに置き換えられます。例: anthropic/claude-opus-4.8google/gemini-2.5-flash。モデル ID は常に vendor/model 形式を使います。

実行

omp -p --model "orcarouter/orcarouter/auto" "Reply with exactly: OK"
期待される出力: OK

注意事項

  • bun >= 1.3.14 が必要です。
  • base_url には /v1 を含める必要があります。
  • apiKey フィールドはキー自体ではなく、環境変数の 名前 を取ります。authHeader: true の場合、Authorization: Bearer <value> として送信されます。
  • モデル参照は provider/model 形式を使います — ここでは orcarouter/orcarouter/auto (プロバイダー orcarouter + モデル ID orcarouter/auto)。
  • 非インタラクティブな実行には -p を使います。
  • oh-my-pi と pi-mono は同じプロジェクトで、どちらもコマンドは omp です。

thinking / reasoning を有効化する

上記のデフォルトのモデルエントリには reasoning: false が指定されています。reasoning を有効にしてエフォート選択を許可するには、モデルに thinking ブロックと compat.reasoningEffortMap を宣言します:
models:
  - id: anthropic/claude-sonnet-4.6
    name: Claude Sonnet 4.6
    reasoning: true
    thinking:
      minLevel: low
      maxLevel: xhigh
      mode: effort
    input: [text]
    contextWindow: 200000
    maxTokens: 8192
    compat:
      supportsDeveloperRole: false
      supportsReasoningEffort: true
      maxTokensField: max_tokens
      thinkingFormat: openai
      reasoningEffortMap: { low: low, medium: medium, high: high, xhigh: high }
そして実行時に model:level サフィックスでエフォートレベルを選択します (minLevel..maxLevel の範囲内):
omp -p --model "orcarouter/anthropic/claude-sonnet-4.6:high" "What is 17*23?"
検証済み: :high サフィックスはエフォートレベルを選択し、OrcaRouter に対して動作します。