Download · v0.1.2

Catflap command line

Choose your system

For servers, lab PCs and scripts: one small program, no window. It shares MCP servers, a sandbox or the computer itself.

Download for Linux Archive · 64-bit · 5 MB

Also for Linux: Archive, 64-bit · Archive, Apple silicon · Archive, ARM 64-bit · Archive, ARM 64-bit

What happens next

Unpack it

Put catflap (catflap.exe on Windows) somewhere on your PATH.

Sign in

Run catflap login. It opens your browser once; catflap login --device works without one.

Start sharing

Run catflap enter --name NAME -- CMD for an MCP server, or plain catflap enter for this computer.

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
Linux	Archive (tar.gz)	64-bit	8 MB	Download
Linux	Archive (tar.gz)	ARM 64-bit	7 MB	Download

Verify a download (optional)

Compare the file's SHA-256 with checksums.txt:

Terminal

$ sha256sum catflap_0.1.2_linux_amd64.tar.gz

checksums.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:

Terminal

$ cosign verify-blob --key cosign.pub --bundle checksums.txt.sigstore.json checksums.txt

For servers and scripts

Command 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.

Unattended machine? Use an API key →

Terminal

# 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

For your own server

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.

Terminal

$ 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

Read the self-hosting guide →

Server downloads →