click-aliases
Add (mutiple) aliases to a click group or command
Decision gist · record as of 2026-08-14
Yes, if you are building a Click CLI and want to support command aliases without boilerplate. The package is lightweight, actively maintained, permissively licensed, and solves a specific problem cleanly. Install it only if you actually need aliases; it adds no value to applications that don't use Click or don't require multiple command names.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; requires click to be installed.
- Low install friction with only two runtime dependencies (click and importlib-metadata).
- Marked active with a recent release, suggesting ongoing maintenance.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions.
last release 2026-07-09 (36 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,596,076 downloads/mo, #2,567 on PyPI
Alternatives
Verify before relying
import click
from click_aliases import ClickAliasedGroup
@click.group(cls=ClickAliasedGroup)
def cli():
pass
@cli.command(aliases=['bar', 'baz'])
def foo():
click.echo('foo')- Whether aliases work with nested subcommand groups or only top-level commands
- Performance impact when a command has many aliases
- Compatibility with Click plugins or custom command classes beyond ClickAliasedGroup
What it is and what it does
click-aliases extends Click's command group system to support multiple names (aliases) for a single command. Instead of registering separate command handlers, you decorate a command with an `aliases` parameter, and ClickAliasedGroup ensures all those names invoke the same underlying function. This is useful in CLI tools where you want to accept both long, descriptive command names and short variants without duplicating code.
The package is minimal and focused: it depends only on click (the CLI framework it extends) and importlib-metadata. It works with modern Python versions (3.10 and later) and carries no known security vulnerabilities. The implementation is straightforward enough that it integrates cleanly into existing Click applications by simply changing the group class.
Use it for
- Provide short aliases for frequently-used CLI commands (e.g., 'ls' as an alias for 'list').
- Support legacy command names while migrating to new naming conventions.
- Allow both verbose and terse forms of the same command for different user preferences.
- Create domain-specific shortcuts in a multi-command CLI tool.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a Click CLI and want to support command aliases without boilerplate.
The package is lightweight, actively maintained, permissively licensed, and solves a specific problem cleanly. Install it only if you actually need aliases; it adds no value to applications that don't use Click or don't require multiple command names.
Install
click-aliases on PyPI
Before you install
Low install friction with only two runtime dependencies (click and importlib-metadata). Marked active with a recent release, suggesting ongoing maintenance.
Requires Python 3.10 or later; requires click to be installed.
License in practice
MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions.
Quickstart
import click
from click_aliases import ClickAliasedGroup
@click.group(cls=ClickAliasedGroup)
def cli():
pass
@cli.command(aliases=['bar', 'baz'])
def foo():
click.echo('foo')Verify before relying
- Whether aliases work with nested subcommand groups or only top-level commands
- Performance impact when a command has many aliases
- Compatibility with Click plugins or custom command classes beyond ClickAliasedGroup
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesclickimportlib-metadata |
| Maintenance | Actively maintained 36 days since the last release |
| First released | |
| Downloads | 3,596,076 / month, #2,567 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: click_aliases-1.0.7-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 › “click command aliases”
- click-aliasesAdds command aliases to Click CLI groups and commands, allowing…
- cloupCloup extends Click with option groups, parameter constraints,…
- click-default-groupExtends Click's Group class to invoke a default subcommand when no…
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 click-default-group · click-didyoumean · click-help-colors · git-python · click-repl · click-configfile · click-plugins · clickclick · click-shell · click-option-group