gemini

Find duplicate files

TLDR

Start a REPL session to chat interactively

$ gemini

Send the output of another command to Gemini and exit immediately

$ [echo "Summarize the history of Rome"] | gemini [[-p|--prompt]]

Override the default model (default: gemini-2.5-pro)

$ gemini [[-m|--model]] [gemini-2.5-flash]

Run inside a sandbox container

$ gemini [[-s|--sandbox]]

Execute a prompt then stay in interactive mode

$ gemini [[-i|--prompt-interactive]] "[Give me an example of recursion in Python]"

Include all files in context

$ gemini [[-a|--all-files]]

Show memory usage in status bar

$ gemini --show-memory-usage

SYNOPSIS

gemini [-h] [-v] [-c FILE] [--tofu] [gemini://URL]

-h, --help
    Display usage information and exit

-v, --version
    Print version number

-V, --verbose
    Enable verbose output for debugging

-c FILE, --config FILE
    Use custom configuration file

--tofu
    Trust certificates on first use (default)

--reject-unknown
    Reject untrusted certificates

-p PORT, --port PORT
    Local port for serving (if applicable)

DESCRIPTION

gemini is a lightweight, text-based client designed for accessing content on the Gemini network, a Gopher-inspired protocol emphasizing simplicity, privacy, and minimalism. Unlike traditional web browsers, it does not support images, JavaScript, or cookies, focusing solely on Gemtext-formatted pages with links, headings, lists, and preformatted blocks.

Users invoke gemini with a gemini:// URL to fetch and display pages in the terminal. It handles client certificates via TOFU (Trust On First Use) for security without CAs. Navigation uses keyboard shortcuts or command-line history. Ideal for low-resource systems, scripting, or privacy-conscious browsing, it connects to "capsules"—small, personal servers hosting Gemini content.

The tool is part of the open-source Gemini ecosystem, promoting decentralized, ad-free hypertext.

CAVEATS

gemini is not a standard Linux command; it requires installation from source (e.g., GitHub repos like sds/gemini) or third-party packages (AUR, Nix). Availability varies by distro. No official man page in base systems.

GEMTEXT RENDERING

Supports headings (#), lists (*), links (=>), blockquotes (>), and preformatted text (```). Links are clickable in interactive mode.

INSTALLATION EXAMPLE

git clone https://github.com/example/gemini-client.git
cd gemini-client
make && sudo make install

HISTORY

Gemini protocol conceived in 2019 by solderpunk as a minimalist web alternative. Early gemini clients like Python-based "gemini.py" appeared in 2019-2020. Modern implementations in Go/C/Rust proliferated by 2021, enhancing TOFU certs and Gemtext rendering amid growing capsule adoption.