@sekaigateway/helper

Configure coding agents and IDEs for SekaiGateway with one command.

Wizard validates your API key against selected plan's /models endpoint, then merges required settings into each agent config.

Works on Windows, macOS, and Linux with Node.js 18 or newer.

Plans

| Plan | Endpoint | |---|---| | Pay as you go | https://api.sekaigateway.xyz/v1 | | Coding plan | https://api.sekaigateway.xyz/v2 |

Wizard asks which plan to use. Non-interactive commands default to Pay as you go; pass --base-url https://api.sekaigateway.xyz/v2 for Coding plan.

Install

# one-shot
npx @sekaigateway/helper

# or global
npm install -g @sekaigateway/helper
sekaigateway-helper

Short alias: sg-helper.

Interactive setup

sekaigateway-helper

Wizard flow:

1. Choose Pay as you go or Coding plan.
2. Enter API key; helper validates it against selected endpoint.
3. Select agents and IDEs.
4. Search and select models from live model list.
5. Confirm changes.

Non-interactive setup

Pay as you go:

sekaigateway-helper apply \
  --key "$SEKAIGATEWAY_API_KEY" \
  --model MODEL_ID \
  --agents claude,opencode \
  --yes

Coding plan:

sekaigateway-helper apply \
  --key "$SEKAIGATEWAY_API_KEY" \
  --base-url https://api.sekaigateway.xyz/v2 \
  --model MODEL_ID \
  --agents claude,opencode \
  --yes

Commands

| Command | Description | |---|---| | sekaigateway-helper / setup | Interactive wizard | | apply | Non-interactive apply; requires API key and model | | status | Show installed and configured agents | | reset | Remove SekaiGateway settings | | validate --key … | Validate key and print models | | list | List supported agents |

Options

| Option | Meaning | |---|---| | --key, -k | API key; SEKAIGATEWAY_API_KEY also works | | --base-url | Override endpoint; default https://api.sekaigateway.xyz/v1 | | --model, -m | Primary model ID | | --subagent-model | Codex/OpenCode subagent model | | --models | Extra model IDs for OpenCode/OpenClaw | | --agents | installed, all, or comma-separated IDs | | --dry-run | Show actions without writing | | --yes, -y | Enable non-interactive default command | | --json | Machine-readable output |

Supported agents

| ID | Tool | Config written | |---|---|---| | claude | [CC] | ~/.claude/settings.json | | codex | [OC] CLI | ~/.codex/config.toml and auth.json | | opencode | OpenCode | ~/.config/opencode/opencode.json | | hermes | Hermes Agent | ~/.hermes/config.yaml and .env | | openclaw | OpenClaw | ~/.openclaw/openclaw.json | | cline | Cline | ~/.cline/data/globalState.json and secrets.json |

Existing settings are merged. Modified files receive a .sekaigateway-backup copy.

Programmatic API

import {
  CODING_PLAN_BASE_URL,
  PAY_AS_YOU_GO_BASE_URL,
  applyToAgents,
  validateApiKey,
} from "@sekaigateway/helper";

const apiKey = process.env.SEKAIGATEWAY_API_KEY;
const validation = await validateApiKey({
  apiKey,
  baseUrl: CODING_PLAN_BASE_URL,
});
if (!validation.ok) throw new Error(validation.error);

await applyToAgents("installed", {
  apiKey,
  baseUrl: PAY_AS_YOU_GO_BASE_URL,
  model: validation.models[0].id,
});

Usage plugins

Usage statusline plugins are disabled until SekaiGateway-specific packages are available.

License

MIT