ez

ez is a macOS command-line tool that lets developers create project-scoped command aliases. Aliases are stored in .ez_cli.json files inside each project directory, which keeps commands tied to their respective repositories and avoids accidental global side effects. The tool is written in Swift, uses only Apple's swift-argument-parser, and is distributed through Homebrew. It supports adding, listing, removing, and running aliases, with parameter placeholders such as {1} and {2}, plus automatic appending of extra arguments. Secrets can be stored in Apple Keychain and referenced inside alias commands, reducing the risk of exposing API keys or tokens in terminal output or process listings. ez also provides zsh tab completion, interactive terminal passthrough, and local run history in a SQLite database. The stats command can show per-alias duration history and trends, while all recorded data remains on the local machine and can be cleared by deleting the relevant files. The project includes build, run, and acceptance-test instructions for Swift-based development. It targets macOS 15.0+ and requires Swift 6.0+ and Xcode 16.4+ for building from source.