cliff
Command Line Interface Formulation Framework
Decision gist · record as of 2026-08-14
Yes. cliff is actively maintained, production-stable, has low install friction, carries no known vulnerabilities, and is in the top 5000 PyPI packages by download volume. Install it if you're building a multi-command CLI tool or need extensibility through entry points; skip it if you're writing a simple single-command script where argparse alone suffices.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later.
- Low install friction with a wheel distribution available.
- Active maintenance with a release within the last 35 days.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 is a permissive license. You can use, modify, and distribute cliff freely in commercial and private projects, provided you include a copy of the license and state significant changes.
last release 2026-07-10 (35 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,567,871 downloads/mo, #3,753 on PyPI
Alternatives
Verify before relying
pip install cliff
from cliff.app import App
from cliff.command import Command
class MyCommand(Command):
def take_action(self, parsed_args):
pass
app = App('myapp')
app.run(['mycommand'])- Whether entry point discovery and dynamic subcommand loading work as expected in your deployment environment.
- Performance characteristics when handling large numbers of subcommands or formatters.
What it is and what it does
cliff is a production-stable framework for building command-line applications. It abstracts away common CLI patterns by using Python entry points to dynamically register subcommands, output formatters, and other extensions, letting you focus on command logic rather than argument parsing and help text generation.
The framework integrates with cmd2 for interactive shell support, PrettyTable for formatted output, stevedore for plugin discovery, and PyYAML for configuration. It's designed for teams building complex CLI tools that need consistent structure, extensibility through plugins, and multiple output formats (table, CSV, JSON, etc.) without reimplementing those features for each command.
Use it for
- Build a multi-command CLI tool (like git or docker) where subcommands are registered via entry points and can be extended by plugins.
- Create an OpenStack-style management CLI where output can be formatted as table, JSON, or YAML without duplicating formatter code.
- Develop an interactive shell application that supports both command-line and REPL modes with consistent command dispatch.
- Build a tool where third-party packages can register new commands or output formatters without modifying the main application.
- Create a CLI for a service or API where you need consistent help text, argument validation, and structured output across many commands.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
cliff is actively maintained, production-stable, has low install friction, carries no known vulnerabilities, and is in the top 5000 PyPI packages by download volume. Install it if you're building a multi-command CLI tool or need extensibility through entry points; skip it if you're writing a simple single-command script where argparse alone suffices.
Install
cliff on PyPI
Before you install
Low install friction with a wheel distribution available. Active maintenance with a release within the last 35 days. Depends on five runtime packages (autopage, cmd2, PrettyTable, stevedore, PyYAML) that are all common utilities.
Requires Python 3.11 or later.
License in practice
Apache-2.0 is a permissive license. You can use, modify, and distribute cliff freely in commercial and private projects, provided you include a copy of the license and state significant changes.
Quickstart
pip install cliff
from cliff.app import App
from cliff.command import Command
class MyCommand(Command):
def take_action(self, parsed_args):
pass
app = App('myapp')
app.run(['mycommand'])Verify before relying
- Whether entry point discovery and dynamic subcommand loading work as expected in your deployment environment.
- Performance characteristics when handling large numbers of subcommands or formatters.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesautopagecmd2PrettyTablestevedorePyYAML |
| Maintenance | Actively maintained 35 days since the last release |
| First released | |
| Downloads | 1,567,871 / month, #3,753 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Typing :: Typed |
Evidence: cliff-4.15.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “CLI framework with subcommands”
- cliffcliff is a framework for building command-line programs that use…
- cementCement is a Python application framework designed specifically for…
- typerTyper builds command-line applications from Python functions using…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also stevedore · click-plugins · knack · dpgui · click · entrypoint · entrypoints · pyodide-cli · cement