diff --git a/fern/products/sdks/generators/cli/overview.mdx b/fern/products/sdks/generators/cli/overview.mdx new file mode 100644 index 000000000..66520752b --- /dev/null +++ b/fern/products/sdks/generators/cli/overview.mdx @@ -0,0 +1,41 @@ +--- +title: CLI generator +description: Generate a production CLI from your API definition — for AI agents and human developers alike. +--- + + +The CLI generator is in active development. [Contact us](https://buildwithfern.com/contact) to learn more or request early access. + + +Fern's CLI generator produces a fully functional command-line tool from the same API spec you already use for SDKs. It ships as a single binary with no runtime dependencies, serving AI agents that need deterministic output and runtime-introspectable schemas as well as human developers who script, debug, and explore. + +Building a CLI by hand is a multi-quarter project — commands, auth, pagination, retries, output formatting, cross-platform builds, shell completions, and keeping it all in sync as the API evolves. The generator handles that automatically. + +## How it works + +The CLI generator plugs into the same Fern workflow as your SDK generators. On every spec change, Fern regenerates the CLI source and opens a PR against your repo. You merge, tag a release, and your build pipeline ships binaries to npm, Homebrew, and GitHub Releases. + +The output is a single statically linked Rust binary. Users drop it onto their PATH and run it. There's no language runtime and no dependencies. + +## Built for agents and humans + + + + Schema and help available as structured JSON. + + + Malformed inputs are caught before any request is sent. + + + The same binary serves MCP over stdio. + + + Colored help, tabular output, and shell completions. + + + Preview a request without sending it. + + + Each release maps to a specific API version. + + diff --git a/fern/products/sdks/sdks.yml b/fern/products/sdks/sdks.yml index 2e9f95fc9..b7448945f 100644 --- a/fern/products/sdks/sdks.yml +++ b/fern/products/sdks/sdks.yml @@ -205,6 +205,13 @@ navigation: - page: Publishing to Postman path: ./generators/postman/publishing-to-postman.mdx slug: publishing + - section: CLI + slug: cli + availability: pre-release + contents: + - page: Overview + path: ./generators/cli/overview.mdx + slug: overview - section: SDK design slug: deep-dives collapsed: true