# Install catgirl with Homebrew, apk, apt, MacPorts, Nix, scoop

Terminal IRC client. Version 2.2a via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:catgirl
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install catgirl
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install catgirl
```

  Evidence: MacPorts ports tree: net/catgirl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add catgirl
```

  Evidence: Alpine Linux edge package indexes: catgirl from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install catgirl
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#catgirl
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ca/catgirl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install extras/sandman
```

  Evidence: Scoop official bucket manifest trees: bucket/sandman.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:catgirl
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/catgirl>
- **Version:** 2.2a
- **Source summary:** Terminal IRC client
- **Homepage:** <https://git.causal.agency/catgirl/about/>
- **Repository:** <https://git.causal.agency/catgirl>
- **Upstream docs:** <https://git.causal.agency/catgirl/about>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://git.causal.agency/catgirl/snapshot/catgirl-2.2a.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- catgirl (cli)
- sandman (cli)
- catgirl (alias)
- sandman (alias)

## Dependencies

- libretls

## Build dependencies

- pkgconf
- universal-ctags

## Uses from macOS

- ncurses

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.2a
- Local data: ok
- Upstream repository: https://git.causal.agency/catgirl/about/
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

catgirl is a terminal IRC client with a curses interface for IRC over TLS. Its README emphasizes focused terminal usability: tab completion, split scroll, URL handling, stable nick coloring, topic diffing, ignore filters, and sandboxing on BSD systems.

### Project history

The official README presents catgirl as part of June McEnroe's IRC suite and points to an IRC Suite essay dated June 19, 2020. The project deliberately keeps a narrow scope: no dynamic configuration, no built-in multi-network management, no reconnection loop, and limited IRCv3 support unless it improves the intended experience.

### Adoption history

The README says catgirl and libtls may be packaged for the user's system, and the supplied package facts list Alpine, Homebrew, Debian, MacPorts, Nix, Scoop, and Ubuntu. That is broad adoption for a deliberately small IRC client.

### How it is used

Users run catgirl with a host or load one or more config files from XDG config directories. The manual covers TLS certificates, SASL PLAIN, CertFP via SASL EXTERNAL, logging to XDG data directories, URL open/copy helpers, and IRC command handling.

### Why package nerds care

catgirl is interesting to package people because it combines old IRC culture with modern packaging details: libtls portability, XDG paths, curses UI, optional macOS sleep/wake wrapper, and BSD sandboxing. It is small, opinionated, and unusually explicit about what it refuses to implement.

### Timeline

- 2020: The README references June McEnroe's IRC Suite essay dated June 19.
- 2025: The generated README page is dated May 8.
- 2026: The cgit page identifies https://git.causal.agency/catgirl as the upstream URL.

### Related projects

- Related projects include pounce, which the README names as an IRC bouncer option, and sandman, the macOS wrapper shipped with catgirl.

### Sources

- <https://git.causal.agency/catgirl>
- <https://git.causal.agency/catgirl/about/>
- <https://git.causal.agency/catgirl/about>
- <https://git.causal.agency/catgirl/about/catgirl.1>
- <https://formulae.brew.sh/api/formula/catgirl.json>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $XDG_CONFIG_HOME/catgirl, $XDG_CONFIG_DIRS/catgirl, ~/.config/catgirl
## Source Database Details

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

## Other Package-Manager Records

- Debian apt - catgirl - 2.2a-1: normalized package name match | Debian stable package indexes: catgirl from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | TLS-only terminal IRC client | https://git.causal.agency/catgirl/about/
- Nix - catgirl: normalized package name match | nixpkgs package indexes: pkgs/by-name/ca/catgirl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - catgirl - 2.2-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: catgirl from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | TLS-only terminal IRC client | https://git.causal.agency/catgirl/about/
- apk - catgirl - 2.2a-r1: normalized package name match | Alpine Linux edge package indexes: catgirl from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | TLS-only terminal IRC client | https://git.causal.agency/catgirl/
- apk - catgirl-doc - 2.2a-r1: normalized package name match | Alpine Linux edge package indexes: catgirl-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | TLS-only terminal IRC client (documentation) | https://git.causal.agency/catgirl/
- MacPorts - catgirl: normalized package name match | MacPorts ports tree: net/catgirl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - extras/sandman: installed executable or alias match | Scoop official bucket manifest trees: bucket/sandman.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [universal-ctags](https://www.automicvault.com/pkg/brew/universal-ctags/) - Build dependency declared by Homebrew.
- [senpai](https://www.automicvault.com/pkg/brew/senpai/) - Shares av.db curated category or tags: chat, cli, irc, networking, terminal.
- [irssi](https://www.automicvault.com/pkg/brew/irssi/) - Shares av.db curated category or tags: chat, cli, irc, networking, terminal.
- [znc](https://www.automicvault.com/pkg/brew/znc/) - Shares av.db curated category or tags: chat, cli, irc, networking.
- [weechat](https://www.automicvault.com/pkg/brew/weechat/) - Shares av.db curated category or tags: chat, cli, irc, networking, terminal.
- [epic5](https://www.automicvault.com/pkg/brew/epic5/) - Shares av.db curated category or tags: chat, cli, irc, networking.
- [icbirc](https://www.automicvault.com/pkg/brew/icbirc/) - Shares av.db curated category or tags: chat, cli, irc, networking.
- [ii](https://www.automicvault.com/pkg/brew/ii/) - Shares av.db curated category or tags: chat, cli, irc, networking.
- [ngircd](https://www.automicvault.com/pkg/brew/ngircd/) - Shares av.db curated category or tags: chat, cli, irc, networking.

## Combined YAML source

View the package source record on GitHub. [combined/catgirl.yml](https://github.com/automic-vault/db/blob/main/combined/catgirl.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
