How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

omarchy-qmk-rgb - Skill - OpenSmartRoute

Name: omarchy-qmk-rgb
Author: kcotugno

Imported from kcotugno/omarchy-qmk-rgb (AGENTS.md). Install upstream with npx skills add kcotugno/omarchy-qmk-rgb. Copyright stays with the author.

AGENTS.md

Guidance for AI coding agents working in this repository.

What this is

An Omarchy shell plugin (kcotugno.qmk-rgb) that controls QMK keyboard RGB lighting over the VIA raw HID protocol. The repo root is the plugin root: omarchy plugin add clones it straight into ~/.config/omarchy/plugins/kcotugno.qmk-rgb/.

File	Role
`manifest.json`	Plugin manifest (`bar-widget`), settings schema and defaults.
`Panel.qml`	Bar button and popout panel. Holds no protocol logic; it shells out to the backend.
`qmk_rgb.py`	Backend CLI. Discovery, VIA protocol, JSON output. Standard library only.
`effects/<vid>-<pid>.json`	Per-keyboard effect names (VIA dropdown format, index = effect number). See README "Effect names".
`effects/presets/*.json`	Shared effect lists that keyboard files reference with `"preset"`.
`tests/test_qmk_rgb.py`	Unit tests against a fake firmware that mimics QMK's `via.c`.

Rules

Git commits: do not add Co-Authored-By: trailers (or any other AI/agent attribution trailers) to commit messages. Commits are authored by the human maintainer only.
Keep qmk_rgb.py dependency-free (Python standard library only). Users install the plugin with a git clone; there is no package step.
Every backend command prints exactly one JSON document on stdout, or {"error": "..."} with a non-zero exit. Panel.qml parses that output, so treat the JSON shape as an API. The one exception is udev-rule, which prints the rule text.
Don't write to EEPROM (save / --save) on every change; the panel debounces saves on purpose.
Effect names belong in mapping files under effects/, not in code. Every mapping needs a source URL. Take names from the keyboard's VIA definition, or from VIA's built-in menus in the-via/reader. Don't guess them. Per-effect controls must come from reading the effect's firmware source (or the definition's showIf rules); cite it in controlsSource.
Plugin folders may not contain symlinks (omarchy plugin validate refuses them).
QML follows Omarchy's shell conventions: import qs.Commons as Commons and use Commons.Color, size with Style.space() / Style.font.*, and build from qs.Ui components (Panel, KeyboardPanel, PanelSlider, Button, ...). Look at $OMARCHY_PATH/shell/plugins/panels/ for patterns.

Checks

python3 -m unittest discover -s tests
omarchy plugin validate .

When you change Panel.qml, also load it in the shell. The checkout may be symlinked as ~/.config/omarchy/plugins/kcotugno.qmk-rgb. File watching does not follow that link, and omarchy-shell shell rescanPlugins keeps the already-loaded Panel.qml, so run omarchy restart shell after editing. Then check the shell log for QML errors (quickshell log -p "$OMARCHY_PATH/shell" | grep qmk-rgb).

When testing against real hardware, don't use --save unless you mean to. Unsaved changes revert when the keyboard is unplugged.

Install omarchy-qmk-rgb and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

omarchy-qmk-rgb

About

AGENTS.md

What this is

Rules

Checks

Install omarchy-qmk-rgb and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews