CLI Generation

Generate CLIs
agents love to use

Turn your OpenAPI spec into a feature-rich CLI with built-in agent support. Interactive TUI mode for humans, machine-readable output for AI agents. One generation, both audiences served.
cloudvault-cli

Trusted by

Agent mode

Agent-ready out of the box

Generated CLIs detect when agents are calling them and automatically switch output to machine-readable formats. No configuration needed.

agent-mode
$
 
(cloudvault
(files
(file (name "report.csv") (size 4096) (modified "2026-03-15"))
(file (name "backup.tar.gz") (size 819200) (modified "2026-03-14"))
(file (name "config.yaml") (size 512) (modified "2026-03-12"))
)
(meta (total 3) (bucket "prod-assets"))
)

Agent mode

Pass --agent-mode to disable interactivity and switch output to TOON, a structured format agents can parse reliably.

llms.txt, skills.md

Expose CLI capabilities through llms.txt for LLM discovery, and skills.md for agent skill registries.

Agent discoverable

Agents find and understand CLI capabilities through built-in help docs, and shell completions — all generated automatically from the API spec.

Machine-readable schemas

Output JSON Schema definitions for all commands and responses. Agents can validate inputs and parse outputs with full type safety.

Install anywhere,
run everywhere

Generated CLIs ship to every major package manager. Users install with a single command. Agents register them as skills.

Feature rich

Built for humans and agents alike

Every generated CLI ships with features that make it a joy to use interactively and trivial to automate.

Interactive TUI

Explore mode with full TUI for browsing commands, viewing help, and navigating API resources interactively.

explore mode
cliv1.0.0
CloudVault: Manage your cloud storage.
>auth/
>files/
>create-bucket
>delete-bucket
>get-user
>list-objects
>upload
1-7 of 7
create-bucket
Create a new storage bucket with the specified configuration
Example:
cli create-bucket --name <value> --region us-east-1
Required Flags:
--namestringName for the bucket [required]
--regionstringAWS region [required]
Optional Flags:
--versioningboolEnable versioning
--aclstringAccess control (private, public)
root↑↓·enter·esc·/·q

Retries

Automatic retries with exponential backoff and configurable retry policies for transient failures.

jq filtering and chaining

Built-in jq support for filtering JSON output. Agents can chain commands together, piping output from one operation into the next.

Pagination

Automatic pagination for list endpoints. Fetch all results or page through them one at a time.

Auth

OAuth 2.0, API keys, and bearer tokens out of the box. Browser-based login flows for humans, programmatic auth for agents.

Extensibility

Add custom commands on top of the generated base CLI. Extend with business logic, workflows, or domain-specific operations.

explore mode
cliv1.0.0
CloudVault: Manage your cloud storage.
>files list
>files upload
>buckets create
>migrate-legacycustom
>health-checkcustom
1-5 of 5
migrate-legacy
Custom command to migrate data from the legacy v1 API
Example:
cli migrate-legacy --source v1 --dry-run
Required Flags:
--sourcestringLegacy API version [required]
Optional Flags:
--dry-runboolPreview without migrating
--batch-sizeintRecords per batch (default 100)
root↑↓·enter·esc·/·q

"We are very happy with Speakeasy's support… Internally, our developers find the SDK useful, it's actively used, and continues to generate valuable feedback. The Speakeasy team has been instrumental throughout our implementation journey."

Gaspard Blanchet

SOFTWARE ENGINEER @ MISTRAL AI

"We've been using Speakeasy to create Dub.co's TypeScript SDK and it's been an amazing experience so far."

Steven Tey

FOUNDER & CEO @ DUB

"Speakeasy has been a really good partner for us. We've been able to get support quickly when needed, and the platform has significantly streamlined our SDK generation process."

Joseph Spurrier

SR. STAFF ENGINEER @ PROVE

"We are very happy with Speakeasy's support… Internally, our developers find the SDK useful, it's actively used, and continues to generate valuable feedback. The Speakeasy team has been instrumental throughout our implementation journey."

Gaspard Blanchet

SOFTWARE ENGINEER @ MISTRAL AI

"We've been using Speakeasy to create Dub.co's TypeScript SDK and it's been an amazing experience so far."

Steven Tey

FOUNDER & CEO @ DUB

"Speakeasy has been a really good partner for us. We've been able to get support quickly when needed, and the platform has significantly streamlined our SDK generation process."

Joseph Spurrier

SR. STAFF ENGINEER @ PROVE

CLI vs MCP

Two interfaces, one API

CLIs and MCP servers serve different personas, runtimes, and distribution models. The question isn't which one wins — it's when to reach for which.

Composability

Chain commands with Unix pipes. An agent can filter, transform, and combine CLI output using jq, grep, and other tools — saving tokens by stripping irrelevant data before it enters context.

Transparency

Every command is reproducible. Copy it from the audit trail, paste it in a terminal, and get the same result. Debugging is straightforward.

LLM familiarity

Models trained on billions of shell scripts already know popular CLIs. For tools like git, curl, and kubectl, agents often don't need to read help text.

Progressive disclosure

Subcommands and --help at every level let agents explore incrementally without loading hundreds of tool definitions upfront.

A practical framework

Who is the audience?
CLI:Developers in coding agents with shell access
MCP:Non-developers, ops teams, or hosted chat interfaces
What runtime is available?
CLI:Local environment with filesystem, env vars, and pipes
MCP:Any HTTP connection — no shell required
How critical is governance?
CLI:Full shell access — powerful but broad blast radius
MCP:Controlled boundaries with scoped auth and rate limiting
How large is the API surface?
CLI:Discover incrementally via subcommands and --help
MCP:All tools declared upfront (use dynamic toolsets for large APIs)

The answer is usually both. Build on a shared core, choose depth of investment by audience.

Read the full analysis

Frequently askedquestions

Ready to ship CLIs that agents love?