Catflap for macOS
The app runs on the computer whose tools you want to share.
There is no build for macOS in v0.1.2 yet. The command line runs nearly everywhere, or see the releases page.
Requirements
Windows
Windows 10 (1809) or 11, 64-bit or ARM. The sandbox needs Podman Desktop; the app shows you how to get it.
macOS
macOS 12 or newer on Apple silicon. Drag the app to Applications; the first time, right-click it and choose Open.
Linux
Needs GTK 4 and WebKitGTK 6: Ubuntu 24.04, Debian 13, Fedora 39 or newer. Older systems: use the command line.
All downloads
v0.1.2 · released 2026-11-03 · all versions · open source under the MIT license| System | Format | Architecture | Size | Download |
|---|---|---|---|---|
| macOS | Archive (tar.gz) | Apple silicon | 4 MB | Download |
| Linux | Archive (tar.gz) | 64-bit | 5 MB | Download |
| Linux | Archive (tar.gz) | ARM 64-bit | 4 MB | Download |
| Windows | Archive (zip) | 64-bit | 5 MB | Download |
| Windows | Archive (zip) | ARM 64-bit | 4 MB | Download |
Verify a download (optional)
Compare the file's SHA-256 with checksums.txt:
$ sha256sum FILEchecksums.txt is signed with the Catflap release key, cosign.pub. To check that the sums are ours, download the key, checksums.txt and its signature, then run cosign:
$ cosign verify-blob --key cosign.pub --bundle checksums.txt.sigstore.json checksums.txtCommand line quick start
Unpack the archive and put catflap on your PATH. On a machine without a browser, catflap login --device shows a code to confirm on your phone or laptop.
# sign in once (opens your browser) $ catflap login --gateway https://catflap.uni-obuda.hu # share any MCP server under the name "weather" $ catflap enter --name weather -- npx -y @mcp/weather # or share this computer's files and shell $ catflap enter
Run your own Catflap
The gateway, this website and the sign-in pages (a Keycloak theme) are open source too: one container beside PostgreSQL and Keycloak. You need a domain with HTTPS and an email account for sign-up emails. The desktop app and the command line work with any Catflap server.
$ git clone https://codeberg.org/hollorol/catflap.git $ cd catflap/deploy && cp .env.example .env # set your domain, passwords and SMTP account in .env, then $ podman compose --profile tls up -d