omni-sync-cloud — Claude Code skill: sync OmniRoute config to cloud
Syncs OmniRoute configuration, provider connections, and settings to and from cloud storage. Manages cloud worker authentication and remote backup targets.
npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -a claude-codeWhat omni-sync-cloud does
The skill exposes OmniRoute's REST API on localhost:20128 for cloud-based config synchronization. Inside: endpoints for cloud worker authentication (POST /api/cloud/auth), credential updates (PUT /api/cloud/credentials/update), model resolution via cloud (POST /api/cloud/model/resolve), model alias management, and sync token operations. All requests require a Bearer token obtained via POST /api/auth/login.
For local development, you can disable the token check with REQUIRE_API_KEY=false. Request and response schemas are documented in the OpenAPI spec at GET /api/openapi/spec. Fits multi-machine OmniRoute setups where you need consistent config across environments.
What it helps with
- synchronize OmniRoute configuration across multiple environments
- manage cloud worker authentication
- back up provider connections to remote storage
- resolve models through cloud worker instead of local routing
- manage model aliases in the cloud
Example prompts for the agent
- sync my OmniRoute config to cloud storage
- authenticate with the OmniRoute cloud worker
- update my cloud backup credentials
How to install omni-sync-cloud
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -a claude-code2Manually: put the files in place
~/.claude/skills/omni-sync-cloud/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/omni-sync-cloud/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -a codex2Manually: put the files in place
.agents/skills/omni-sync-cloud/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -a cursor2Manually: put the files in place
.cursor/skills/omni-sync-cloud/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute omni-sync-cloud2Manually: put the files in place
.github/skills/omni-sync-cloud/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/omni-sync-cloudManually: put the files in place
.devin/skills/omni-sync-cloud/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set34
The whole set →Similar
Questions about omni-sync-cloud
How to install omni-sync-cloud in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -a claude-code. The skill will appear in ~/.claude/skills/omni-sync-cloud/SKILL.md.
What does omni-sync-cloud do?
The skill synchronizes OmniRoute configuration, provider connections, and settings to and from cloud storage. It also manages cloud worker authentication and remote backup targets.
Does omni-sync-cloud require authentication?
Yes, all requests need a Bearer token or session cookie. Obtain a token via POST /api/auth/login or set REQUIRE_API_KEY=false for local development.
Source text
SKILL.md · MIT
---
name: omni-sync-cloud
description: Synchronise OmniRoute configuration, provider connections, and settings to/from cloud storage. Manage cloud worker authentication and remote backup targets.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->
## Overview
Synchronise OmniRoute configuration, provider connections, and settings to/from cloud storage. Manage cloud worker authentication and remote backup targets.
## Authentication
All requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development.
## Endpoints
### POST /api/cloud/auth
Authenticate with cloud worker
Authenticates with the OmniRoute cloud worker for remote access.
```bash
curl -X POST http://localhost:20128/api/cloud/auth \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### PUT /api/cloud/credentials/update
Update cloud worker credentials
```bash
curl -X PUT http://localhost:20128/api/cloud/credentials/update \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### POST /api/cloud/model/resolve
Resolve model via cloud
Resolves a model request through the cloud worker.
```bash
curl -X POST http://localhost:20128/api/cloud/model/resolve \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### GET /api/cloud/models/alias
Get cloud model aliases
```bash
curl http://localhost:20128/api/cloud/models/alias \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
```
### PUT /api/cloud/models/alias
Update cloud model alias
```bash
curl -X PUT http://localhost:20128/api/cloud/models/alias \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### POST /api/sync/cloud
Sync with cloud
```bash
curl -X POST http://localhost:20128/api/sync/cloud \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### POST /api/sync/initialize
Initialize cloud sync
```bash
curl -X POST http://localhost:20128/api/sync/initialize \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### GET /api/sync/bundle
GET sync › bundle
```bash
curl http://localhost:20128/api/sync/bundle \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
```
### GET /api/sync/tokens
GET sync › tokens
```bash
curl http://localhost:20128/api/sync/tokens \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
```
### POST /api/sync/tokens
POST sync › tokens
```bash
curl -X POST http://localhost:20128/api/sync/tokens \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
```
### DELETE /api/sync/tokens/{id}
DELETE sync › tokens › <id>
```bash
curl -X DELETE http://localhost:20128/api/sync/tokens/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
```
## Payloads
See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.
© cheaper-inference · MIT · cheaper-inference/OmniRoute