npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@ikenga/pkg-engine-openrouter

v0.2.1

Published

OpenRouter engine adapter for Ikenga. Runs chat sessions on any model available through OpenRouter, using a single API key.

Readme

@ikenga/pkg-engine-openrouter

OpenRouter engine pkg for Ikenga. It lets the Ikenga shell run chat sessions on any model available through OpenRouter, using a single API key.

| | | |---|---| | Pkg id | com.ikenga.engine-openrouter | | Kind | engine | | Maturity | Beta | | Requires | An OpenRouter API key, and network access to https://openrouter.ai/api/ |

What it is

OpenRouter is a hosted API that fronts many model providers behind one OpenAI-compatible endpoint. This pkg registers it as an engine in the Ikenga shell. Unlike the Codex and Antigravity engines there is no CLI to install: the engine talks to OpenRouter over HTTPS.

Two surfaces ship from this pkg:

  • createAcpEngine(host) (and the legacy createEngine(host)): the engine the manifest declares. Its methods forward to a host the shell injects (the shell's Tauri ACP commands), and the shell makes the HTTPS requests. See src/acp-engine.ts.
  • OpenRouterHttpEngine / createHttpEngine(config): a self-contained, in-process HTTP engine for places with no shell host, such as Node tooling and tests. It streams the OpenAI-compatible /chat/completions endpoint, normalizes reasoning tokens (both the reasoning / thinking delta fields and inline <think> tags), and accumulates streamed tool calls. It reads the key from OPENROUTER_API_KEY unless you pass apiKey.

Model selection is free text, forwarded as written. There is no pinned model list.

Install

ikenga add @ikenga/pkg-engine-openrouter

The pkg is also published to npm as @ikenga/pkg-engine-openrouter. It is listed in the Ikenga registry.

Then:

  1. Create an API key at https://openrouter.ai/keys.
  2. Set it in the pkg's openrouter_api_key setting. It is stored in the vault, not in plain settings.
  3. Optionally set the default model (default openrouter/auto).

Capabilities

| Capability | Supported | Note | |---|---|---| | Streaming | Yes | Server-sent events from /chat/completions. | | Tool use | Yes | Model-dependent. The engine reports the tool calls the model asks for and ends the turn. It does not run tools itself. | | Thinking | Yes | When the model returns reasoning tokens. | | Artifacts | No | | | File attachments | No | | | Image input | No | Prompts are text only. Image and audio blocks are refused. | | Slash commands | No | | | Model switching | Yes | Any OpenRouter model id. | | Prompt caching | No | | | MCP | No | | | Session resume | In-process only | History is held in memory by the running shell. A session can be replayed while that process is alive. It does not survive a restart. |

Known limits

  • Cannot resume after a restart. OpenRouter's endpoint is stateless and the conversation history lives only in the shell process that created it. After the shell restarts, an earlier OpenRouter session cannot be resumed. The shell returns an error rather than opening an empty transcript.
  • No agentic loop. The engine reports tool calls but never executes them, so it suits chat and simple function-calling flows rather than autonomous multi-step work.
  • Text only. No image input, file attachments, artifacts, slash commands or MCP.
  • Model behaviour varies. Tool use and reasoning output depend on the model you choose.

Maturity

Beta. Behaviour and capabilities may change between releases.

Configuration

| Setting | Type | Default | Description | |---|---|---|---| | openrouter_api_key | secret | none | Your OpenRouter API key. Stored in the vault and passed to the adapter as OPENROUTER_API_KEY. | | model | string | openrouter/auto | Default model id, for example openrouter/auto, anthropic/claude-3.7-sonnet or deepseek/deepseek-r1. openrouter/auto lets OpenRouter choose. | | base_url | string | https://openrouter.ai/api/v1 | API endpoint. Usually left unchanged. |

Permissions

Declared in manifest.json:

  • net: https://openrouter.ai/api/**. This is the only place the API key may be sent.
  • vault.keys: OPENROUTER_API_KEY.
  • fs.read and fs.write: $pkg_data/sessions/**.

License

Apache-2.0. See LICENSE at the monorepo root.