# 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/210a2053c8e007daf9ae39c2a21daaed9b2ddd07d63ecffa597050361e73650c-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
- **Package manager page:** <https://formulae.brew.sh/formula/clitest>
- **Version:** 0.5.0
- **Source summary:** Command-Line Tester
- **Homepage:** <https://github.com/aureliojargas/clitest>
- **Repository:** <https://github.com/aureliojargas/clitest>
- **License:** MIT
- **Source archive:** <https://github.com/aureliojargas/clitest/archive/refs/tags/0.5.0.tar.gz>
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- clitest (cli)
- clitest (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 0.5.0
- Local data: ok
- Upstream repository: https://github.com/aureliojargas/clitest
- Upstream latest detected: 0.5.0 (current)
- info: No package-manager update timestamp was available.
## 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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** clitest
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 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/210a2053c8e007daf9ae39c2a21daaed9b2ddd07d63ecffa597050361e73650c-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


## Related links

- [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [powershell](https://pkg.so/brew/powershell/) - Shares pkgdb curated category or tags: automation, cli, developer-tools, shell.
- [parallel](https://pkg.so/brew/parallel/) - Shares pkgdb curated category or tags: automation, cli, developer-tools, shell.
- [expect](https://pkg.so/brew/expect/) - Shares pkgdb curated category or tags: automation, cli, developer-tools, testing.
- [tox](https://pkg.so/brew/tox/) - Shares pkgdb curated category or tags: automation, cli, developer-tools, testing.
- [entr](https://pkg.so/brew/entr/) - Shares pkgdb curated category or tags: automation, cli, developer-tools, testing.
- [retry](https://pkg.so/brew/retry/) - Shares pkgdb curated category or tags: automation, cli, developer-tools, shell.
- [shellspec](https://pkg.so/brew/shellspec/) - Shares pkgdb curated category or tags: cli, developer-tools, shell, testing.
- [molecule](https://pkg.so/brew/molecule/) - Shares pkgdb curated category or tags: automation, cli, developer-tools, testing.
- [shelltestrunner](https://pkg.so/brew/shelltestrunner/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line.
- [atf](https://pkg.so/brew/atf/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, shell, testing.

## 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
- package-page enrichment
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
