Specli

specli

[](https://www.npmjs.com/package/specli)

Turn any OpenAPI spec into a CLI.

Demo

Compile this weather OpenAPI spec to an executable:

npx specli compile https://raw.githubusercontent.com/open-meteo/open-meteo/refs/heads/main/openapi.yml --name weather

Ask an agent what the current weather is:

opencode run 'Using ./out/weather what is the current weather in new york city'

Install

npm install -g specli

Or use directly with npx/bunx:

npx specli exec ./openapi.json __schema
bunx specli exec ./openapi.json __schema

Commands

exec

Run commands dynamically from any OpenAPI spec URL or file path. Works with both Node.js and Bun.

specli exec    [args...] [options]

**Examples:**

# Inspect available commands
specli exec ./openapi.json __schema

# Machine-readable schema output
specli exec ./openapi.json __schema --json

# Minimal schema (best for large specs)
specli exec ./openapi.json __schema --json --min

# Run an operation
specli exec ./openapi.json users list

# Run with path parameters
specli exec ./openapi.json users get abc123

# Preview the curl command without executing
specli exec ./openapi.json users list --curl

# Dry run (show request details without executing)
specli exec ./openapi.json users list --dry-run

compile

Bundle an OpenAPI spec into a standalone executable. **Requires Bun.**

specli compile  [options]

**Options:**

Option	Description
--name	Binary name (default: derived from spec title)
--outfile	Output path (default: ./out/)
--target	Cross-compile target (e.g. bun-linux-x64)
--minify	Enable minification
--bytecode	Enable bytecode compilation
--no-dotenv	Disable .env autoload
--no-bunfig	Disable bunfig.toml autoload
`--server <u