Amzani/onecli-registry

API registry for onecli.dev — One CLI for every API

★ 0Forks 0GitHub ↗Compare

README

onecli Registry

API registry for onecli.dev — One CLI for every API.

What is this?

This repo contains registry.json, an index of OpenAPI specs that can be used with onecli. When you run onecli add stripe, onecli looks up the spec URL from this registry.

Adding an API

  1. Fork this repo
  2. Add an entry to registry.json:
{
  "name": "your-api",
  "display_name": "Your API",
  "description": "Short description of your API",
  "spec_url": "https://url-to-your-openapi-spec.json",
  "category": "category",
  "tags": ["tag1", "tag2"],
  "homepage": "https://your-api.com",
  "added": "2026-03-10"
}
  1. Open a PR

Requirements

  • The spec_url must point to a valid OpenAPI 3.x spec (JSON or YAML)
  • The name must be lowercase, alphanumeric with hyphens only
  • The spec must be publicly accessible

Using the registry

# Install onecli
brew install onecli

# Add an API from the registry (no --spec needed)
onecli add stripe

# Or add any API with a custom spec
onecli add my-api --spec https://example.com/openapi.json

Contributors

Amzani

Issues