# Install clitest with Homebrew, apt, dnf, pacman

Command-Line Tester. Version 0.5.0 via Homebrew; verified from local package data. Also installable with debian: sudo apt install clitest.

## Install

```sh
sudo av install brew:clitest
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install clitest
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install clitest
```

  Evidence: Debian stable package indexes: clitest from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install clitest
```

  Evidence: Fedora Rawhide package metadata: clitest from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- pacman (92%):

```sh
sudo pacman -S clitest
```

  Evidence: Arch Linux sync databases: clitest from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:clitest
- **Package manager:** Homebrew
- **Version:** 0.5.0
- **Source summary:** Command-Line Tester
- **Homepage:** <https://github.com/aureliojargas/clitest>
- **Repository:** <https://github.com/aureliojargas/clitest>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- clitest (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.5.0
## Project history and usage

clitest is a portable POSIX shell script for testing command-line sessions by comparing commands and expected output written in a terminal-like transcript.

### Project history

clitest was published by Aurelio Jargas as a small single-script command-line testing tool. The upstream README frames it as applying the doctest idea to Unix command lines: documentation-like shell sessions can become executable tests.

### Adoption history

The project is intentionally small, but it reached several developer-oriented package channels: the batch input records Homebrew, Debian, Fedora, Arch, and Ubuntu packages. The README also documents a Docker image and points to funcoeszz test files as a larger real-world suite using the clitest format.

### How it is used

Users write a text or Markdown file containing prompts, commands, and expected output, then run `clitest FILE` to execute and check those examples. The README documents prefix handling for indented Markdown code blocks and inline expected-output markers such as `#=>`.

### Why package nerds care

clitest matters to package nerds as a tiny, portable test runner for command-line examples. It is the sort of tool that can smoke-test package documentation, man-page examples, and shell snippets without bringing in a language-specific test framework.

### Timeline

- 2013: GitHub repository created and early 0.1.0 tag committed.
- 2023: Version 0.5.0 tag committed.
- 2023: Upstream README documents direct script installation, Docker use, Markdown extraction, and real-world clitest suites.

### Related projects

- Related projects and concepts include Python doctest, doctest.fish for fish shell users, shellspec-style shell testing tools, and command-documentation test suites such as funcoeszz's clitest files.

### Sources

- <https://github.com/aureliojargas/clitest#readme>
- <https://github.com/aureliojargas/clitest/releases>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Other Package-Manager Records

- Debian apt - clitest - 0.5.0-1: normalized package name match | Debian stable package indexes: clitest from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | portable testing tool for Unix command lines | https://github.com/aureliojargas/clitest
- Ubuntu apt - clitest - 0.4.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: clitest from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | portable testing tool for Unix command lines | https://github.com/aureliojargas/clitest
- dnf - clitest - 0.5.0-10.fc45: normalized package name match | Fedora Rawhide package metadata: clitest from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Command Line Tester | https://github.com/aureliojargas/clitest
- pacman - clitest - 0.5.0-2: normalized package name match | Arch Linux sync databases: clitest from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Perform automatic testing in Unix command lines | https://github.com/aureliojargas/clitest


## Combined YAML source

View the package source record on GitHub. [combined/clitest.yml](https://github.com/mxcl/pkgdb/blob/main/combined/clitest.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph