Blog

Introducing the Cliffy blog

c4spar1 min readmeta

Release notes and articles about building command line tools are now available at cliffy.io/blog.

The Cliffy chevron flowing into a stack of Markdown documents.

Cliffy now has a blog. It's where release notes live, along with deeper dives into the framework's design and articles about building command line tools in general. If you're new to the project, the Cliffy 1.0 article is more than release notes: it introduces Cliffy, explores its core features, and compares building the same CLI with several frameworks. Release notes for 1.1 and 1.2 are available too.

Posts live next to the website source in content/blog/, are baked into the deployment at build time, and are available as an RSS feed at /blog/feed.xml.

Writing a post

A post is a markdown file with a YAML frontmatter block, and the full markdown pipeline of the docs is available, so code blocks are highlighted and carry type information on hover:

import { Command } from "@cliffy/command";

await new Command()
  .name("greet")
  .arguments("<name:string>")
  .action((_options, name) => console.log(`Hello, ${name}!`))
  .parse();

Frontmatter also carries release metadata and controls the optional terminal or image hero.

Reading along

Every post is also served as raw markdown at /blog/<slug>.md, and the blog is listed in /llms.txt so agents can find it alongside the documentation.