# Cloud Config Sync

Syncs OmniRoute configuration and provider connections to and from cloud storage.

- Repository: https://github.com/cheaper-inference/OmniRoute (83611 stars)
- Category: DevOps
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -g -a claude-code -y`
Codex: `npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -g -a codex -y`
Cursor: `npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -g -a cursor -y`
Gemini CLI: `npx skills add cheaper-inference/OmniRoute --skill omni-sync-cloud -g -a gemini-cli -y`

## Description

Synchronise OmniRoute configuration, provider connections, and settings to/from cloud storage. Manage cloud worker authentication and remote backup targets.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!-- 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

The rest: https://github.com/cheaper-inference/OmniRoute/blob/HEAD/skills/omni-sync-cloud/SKILL.md