name	aurl
description	Turn any API into a CLI command. Register OpenAPI or GraphQL endpoints by name, then explore and invoke them. Built for AI agents to use APIs like tool calls.

aurl

Turn any API spec into a CLI command. Register APIs by name, explore their endpoints, and make requests.

Commands

aurl add [name] [openapi.json URL or path]       # register an API
aurl add [name] [spec] --base-url [URL]           # override base URL
aurl add [name] [spec] --header "Key: Value"      # manual auth header
aurl add --graphql [name] [endpoint]              # register a GraphQL API
aurl list                                          # list registered APIs
aurl remove [name]                                 # unregister
aurl auth [name]                                   # reconfigure auth

Using a Registered API

aurl [name] --help                                # see all endpoints, params, enums, response codes
aurl [name] describe METHOD /path                 # detailed docs for one endpoint
aurl [name] describe [field]                      # detailed docs for a GraphQL field/type
aurl [name] docs                                  # open external docs in browser
aurl [name] METHOD /path                          # make a REST request
aurl [name] METHOD /path '{"key":"value"}'        # make a REST request with JSON body
aurl [name] '{ graphql query }'                   # run a GraphQL query
aurl [name] '{ query }' '{"var":"val"}'           # GraphQL with variables

Discovery Workflow

When working with an unfamiliar registered API:

aurl [name] --help — scan all endpoints grouped by tag
aurl [name] describe METHOD /path — read full docs for an endpoint before calling it
Make the request — enum params are validated before sending, missing required body fields trigger a warning

Notes

Auth is auto-detected from the spec's securitySchemes during aurl add
Query params go inline in the path: aurl [name] GET '/path?key=value'
Quote paths with ? to prevent shell globbing
On 4xx errors, the CLI suggests the expected request body from the spec

aurl

Turn any API spec into a CLI command. Register APIs by name, explore their endpoints, and make requests.

Commands

aurl add [name] [openapi.json URL or path] # register an API aurl add [name] [spec] --base-url [URL] # override base URL aurl add [name] [spec] --header "Key: Value" # manual auth header aurl add --graphql [name] [endpoint] # register a GraphQL API aurl list # list registered APIs aurl remove [name] # unregister aurl auth [name] # reconfigure auth

Using a Registered API

aurl [name] --help # see all endpoints, params, enums, response codes aurl [name] describe METHOD /path # detailed docs for one endpoint aurl [name] describe [field] # detailed docs for a GraphQL field/type aurl [name] docs # open external docs in browser aurl [name] METHOD /path # make a REST request aurl [name] METHOD /path '{"key":"value"}' # make a REST request with JSON body aurl [name] '{ graphql query }' # run a GraphQL query aurl [name] '{ query }' '{"var":"val"}' # GraphQL with variables

Discovery Workflow

When working with an unfamiliar registered API:

aurl [name] --help — scan all endpoints grouped by tag

aurl [name] describe METHOD /path — read full docs for an endpoint before calling it

Make the request — enum params are validated before sending, missing required body fields trigger a warning

Notes

Auth is auto-detected from the spec's securitySchemes during aurl add

Query params go inline in the path: aurl [name] GET '/path?key=value'

Quote paths with ? to prevent shell globbing

On 4xx errors, the CLI suggests the expected request body from the spec